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I TECHNICAL OVERVIEW OF PORTFOLiO 

The Atari Portfolio is the first product that provides the functionality of a Standard 
desktop PC in a package which can fit into a pocket. 

The main requirements for the Portfolio technology are that the product should be 
pocketable, compatible, have low power consumption and above al! be inexpensive 
to purchase, 

The Portfolio is the size of a Video cassette (VHS) and weighs less than one pound 
(450 grams). 

The Portfolio provides a high degree of Software compatibility with the industry 
Standard desktop microcomputer, the IBM PC. This is achieved by supplying a PC- 
compatible BIOS, MS-DOS-compatible operating System as well as Lotus 1-2-3 file- 
compatibie spreadsheet. The Portfolio also provides an expansion bus connector 
which ailows peripherals to be connected to the product. 

The Portfolio is inexpensive to manufacture as the Software is provided on and runs 
from ROM and with the large scale Integration of System logic, using an ASIC the 

overail component cost and size are reduced. 

The Portfolio uses credit card-sized memory cards instead of magnetic disks, and a 
LCD display. These components have a low power consumption and hence the 
product can use the consumer Standard AA batteries and achieve a long battery life. 

This Technical Reference Guide describes the Portfolio technology in detai! and 
provides the necessary Information for a third party to develop hardware and 
Software applications for the Portfolio, This document only provides Information 
specific to the Portfolio technology. If you want information on the Standard IBM PC 
hardware, BIOS, or MS-DOS then the foliowing publications should provide the 
required information: 

IBM Personal Computer Publications: 

Technical Reference (BIOS and Hardware) 

Disk Operating System (PC-DOS) 

Microsoft Press Publications ISBN Reference 

Peter Norton Programmer’s Guide 0-914845-46-2 

The MS-DOS Encyclopedia 1-55615-049-0 

IBM ROM BIOS (Quick Reference Series) 1-55615-135-7 

MS-DOS Functions (Quick Reference) 1 -55615-128-4 
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2. HARDWARE 


2.1. System Description 
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2.1.1 Microprocessor Unit 


The Portfolio uses an 80C88 MPU, the same processor as the original IBM PC, lt is 
the CMOS static Version which allows the MPU clock to be halted when no 
Processing is taking place and hence power consumption is kept to a minimum. The 
Portfolio is faster than the original IBM PC, the dock running at 4.9152MHz instead 
of 4.77MHz. However, the Portfolio processor uses minimum mode, so bus lock 
cannot be used. (See section 2.6 for more details.) 


2.1.2 System RAM 

The current Portfolio uses four 32 KByte Static RAM Chips, giving a total of 
128KBytes. These have a very low standby current which allows them to maintain 
their contents for extended periods with minimal drain on baiteriesTSee section 2 2 
for more details.) 


2.1.3 System ROM 

The current Portfolio has in total 256 KBytes of ROM which contains all of the BIOS, 
DOS, command processor and application Software. This ROM currently comprises 

of two 128 KByte Chips. (See section 2.2 for more details.) 


2.1.4 LCD Display 

The LCD is a 240 x 64 pixel display. It is driven by a set of LCD screen drivers which 
are controlled by a graphics LCD Controller, The screen behaves in the same way 
as an IBM PC monochrome text screen (MDA). The Controller also uses a dedicated 
Video RAM chip and a character generator ROM. For graphics it is pixel compatible 
provided the PC-compatible BIOS is used. (See sections 2.2.2, 2.8 and 3.7.) 


2.1.5 Tone Dialler + Sound 

The Portfolio Speaker is driven by a Dual Tone Multiple Frequency (DTMF) 
telephone diafler chip. This produces all the necessary dual tones required for tone 
dialling plus a set of melody tones for musicai applications. The keyboard click also 
uses this Circuit. (See section 3.3.1.) 



2,1.6 ASIC 


This Circuit contains most of the System logic. (See section 2.4 for more details.) 


2.1.7 Keyboard 

The Portfolio uses a 63-key QWERTY 'switch-matrix' koyboard. The ASIC 

generates a set of physical scan-codes which are translated by the BIOS to IBM PC- 
compatibfe scan-codes. 


2.1.8 Memory Card Connector 

The Portfolio contains a memory card connector on the side of the product. Credit 
card-sized memory cards can be inserted into this connector, allowing for data and 
programs to be accessed by the Portfolio Software. (See section 2,2.4, 3.6.) 


2.1.9 Expansion Port 

On the right-hand side of the product there is a 60-pin connector which provides the 
necessary Signals for various peripherals, (See section 2.6, 2.7 and 3.5.) 


2.1.10 Power Supply Unit 

1 his supplies all the power required in the System. It produces various supply iines 
I he circLut mcludes a switching regulator that steps up the voltage from 3 AA cells to 
5V. The regulator may be switched off. (See section 2.5 and 3.8 for more details.) 
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2.2 


SYSTEM MEMORY 


2.2.1 Memory Map 



Diagram of Portfolio Memory Map 

(all addresses in hex) 




2.2.2 RAM 


There is a totai of 128 KBytes of orrboard RAM provided with the Portfolio. 

4 KBytes ot this RAM are mapped to BOOOOh to make up the Video RAM which is 
compatible with the IBM PC MDA screen, This gives a total System RAM of 124 
KBytes. 

The System RAM can be expanded up to 636 KBytes by use of memory expansion 
peripheral(s), 

The Portfoiio allows the user to have an internal RAM disk (known as C:) which can 
be user configured, This RAM disk uses the top of the System RAM. 


2.2.3 System ROM A 

This contains the BIOS, operating System and some of the application Software. The 
reset vector sits at FFFFOh. This ROM cannot be mapped out of the memory map. 


2.2.4 System ROM B 

This contains the rest of the application Software. This ROM may be switched out of 
the memory map and replaced by either the internal memory card or an external 
memory card on a peripheral. The BIOS disk Services would normally perform this 
switching function. (See section 3.6.) 
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2.3 Memory Cards 


The Portfolio uses credit card-sized memory cards which are specially designed for 
the Portfolio. There are similar memory cards available from other vendors. DO 
NOT use these cards with the Portfolio as they may harm the card and the Portfolio. 

These come in three main types: RAM, OTPROM and Mask ROM. (See below for 
explanation.) 

The cards are formatted to look like MS-DOS disks. It is possible to run a program 
directly from a card and hence reduce the amount of System RAM required. (See 
section 3.6.3 for more details.) 


2.3,2 RAM cards 

The RAM cards are currently available in three main sizes; 32, 64 and 128 KBytes. 

The cards are made up of Static RAM and each card contains a lithiüm back-up 
cell. This cell will maintain the data on a card when it is not in a Portfolio for a year 
or more. 


2.3.3 OTPROM cards 

The One Time Programmable ROMs cards that are currently available are 64 and 
128 KBytes. They are read-only cards and would typically be used for holding fixed 
data or Software. They can be programmed in a Standard EPROM programmier like 
a normal PROM (see section 4.4). 


2.3.4 Mask ROM 

These cards are "factory programmed” and have a low unit cost, This makes them 
suitable for issuing mass production Software. Currently available only as 128 KByte 
Option. 


2.3.5 Future Card Sizes 

The Portfolio BIOS contains support for ROM and RAM cards of greater than 128 
KBytes. If these become available, they will be made up of 128 KByte pages with a 
page register at offset OOOAh. It is imperative that NO application Software uses this 
memory card iocation, no matter what the card capacity. 
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2-3.6 Memory Card Pirrout 


Below is a pin out of typicaf memory cards. Differences between the various card 

types are highüghted. (Pin 1 is on the right with the connections up and pointing to 
you.) 


Pin 

COMMON RAM OTPROM : Mask ROM 



32k 64k 128k 


1 

A16 



2 

A15 



3 

4 

AI? 

VBB VPP NC VPP NC 


5 

n 14 

A7 



6 

A6 



7 

A5 



8 

A4 



9 

A3 



10 

A2 



11 

AI 



12 

A0 



13 

DO 



14 

Dl 



15 

D2 



16 

GND 



17 

D3 



18 

D4 



19 

D5 



20 

D6 



21 

D7 



22 

CE 



23 

A10 



24 


OE OE OE/VPP OE 

OE 

25 

All 



26 

A9 



27 

A8 



28 

A13 



29 

A14 



30 


WE NC NC PGM 

NC 

31 

VCC 



32 

CDET 



Noles: 

NC 

No interna! connection. 



VCC 

Operating supply: 5 Volts. 



GND 

Signal ground 



CDET 

This is the smail pin (internalty connected 




to GND), used to detect presence ol card. 



Ax 

Card address line x. 



Dx 

Card data line x. 



VBB 

Card battery voltage. 



PGM 

OTPROM program line. 0V in proqram mode 


VPP 

OTPROM program voltage. 




12.5V Program mode, 5V normally 



OE 

Low to indicate a read cycle. 



WE 

Low to indicate a write cycle. 
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2.4 Custom ASIC Chip 


The Portfolio custom ASIC Chip provides most of the necessary System logic. It is a 
gate array implemented using Silicon gate CMOS technology, which allows for very 
low power and high speed Operation. 

This Application Specific Integrated Circuit (ASIC) is used to generate all the select 
lines for the memory, memory cards and other System blocks. It also contains 
several System control functions. These functions are controlled using a set of 
regisfers which control the various parts of the System such as memory chip size. 


2.4.1 System Clock 

The clock is 4.9152MHz, with a 50% duty cycle produced by a crystal oscillator. The 
clock can go in to a stop mode. A custom chip Interrupt will cause the clock to 
restart. 


2.4.2 Timer 

The System timer tick count is generated from a 32768Hz crystal oscillator which will 
generate an interrupt every 1 second or every 128seconds. 


2.4.3 Keyboard Controller 

The keyboard Controller will scan an eight by eight push to make key-switch matrix. 
A pressed or released key will cause an interrupt. The processor will obtain the scan 
code from a control register. 


2.4.4 Interrupt Händler 

This Controls the critical error for the memory cards, keyboard and tick count 
interrupt, This is extended outside the ASIC to allow for externa! peripheral 
interrupts. 


2.4.5 Soft Contrast for LCD 

A control register holds the contrast value for the LCD display. 



2.5 Power Supply Unit 


The Portfolio has several power supply lines and control lines. These are used for 
various purposes and have different power characterisfics as explained below. They 
are all available on the expansion bus. 

When batteries and a power supply are connected Io the Portfolio simultaneously 
the Portfolio will be supplied by the higher voltage ("initial source"). 

(See section 3.8 for Software issues.) 


2.5.1 Power Modes 

i) NO POWER MODE 

This is the state when no initial source is connected to the Portfolio (e.g. changing 
ba tenes). If an initial source has been supplied and then reimoved, the System RAM 
will be backed up by an internal capacitor. 

ii) OFF MODE 

This is the state the Portfolio goes into when the ’OFF’ command is used. The 
custom chip and RAM are powered directly from the initial source. 

iii) STANDBY MODE 

This is the state that the Portfolio will be in while waiting for a key press, The whole 
System is powered from the output of the internal five voli regulator. However, the 
System clock CCLK is halted in order to stop the processor and save power. 

iv) RUN MODE 

This the state in which the Portfolio is actually Processing. The whole System rs 
powered from the output of the five volt regulator and the System clock CCLK is 
runnmg, thus causing maximum power usage. 


2.5.3 VCC (Memory Card supply voltage) 

This line follows 5VS. It is designed to be used by an external memory card so that 

plugging in and pulling out a card will not cause spikes on 5VS. This line should not 
be used for any other purpose. 
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2.5.2 5VS Five Volt switched supply line 

This is the output of the five voll regulator. Düring STANDBY and RUN modes, this 
iine will supply five vofts. At any other time this line will float low. Peripherais may be 
designed that use this supply. 

5VS is capable of supplying up to 40 mA at 5V +/- 5 % to a peripherai, This assumes 
that the main unit is taking maximum power. The Portfolio will run correctly outside 
the 5% supply tolerance; however, this is not recommended. 

Use of 5VS by a peripherai will decrease the unit‘s batiery life. Also, since alkaline 
batteries develop a voltage drop (due to internal resistance) the low battery warning 
will occur when the batteries are less depleted than if the peripherai was not 
plugged in. 


2.5.4 VRAM (Memory Power Supply) 

This is the supply for the System RAM: 

STANDBY and RUN 4.5V 

OFF initial source voltage - 0.5V 

NO POWER current voltage across a capacitor. 

Düring NO POWER Mode the voltage will decay, so care should be taken that no 
current is taken from this line or the System RAM could be corrupted. When the cold 
reset switch js pressed this iine is pulied to GND through a small resistor. 


2.5.5 VEXT (External voltage) 

This is the external power supply voltage connected directly to the externa! jack 
socket. This enables peripherals with their own power source to make use of the 
Portfolio external power supply, lt is possible to supply the Porlfolio via this 
connection. However, care should be taken to avoid external power supply conflicts. 


2.5 6 BATD (Battery detection Signal) 

This control signal is used to isolate System RAM from the resi of the circuit when 
the batteries are removed. It would normally carry the initial source but when the 
initial souiee is removed, it is pulied to GND. This iine could be used by a peripherai 
to access the initial source. 




2.6 Portfolio txpansion Port 


The Portfolio uses a 60-pin expansion connector which can take custom designed 
peripherals, (See section 4 for more details on current ränge of peripherals.) 


2.6.1 Expansion Port Connector Pin-out 

Location of pin 1 - If you are looking into the Portfolio expansion port then the top 
pin ori the right is 1 and the bottom right is 2. 


ABUF 

. 1 

2. 

5VS 

REDY 

. 3 

4. 

VCC 

BCOM 

. 5 

6. 

NCC1 

NMD1 

. 7 

8. 

WAKE 

DTR 

. 9 

10 . 

DEN 

PDET 

.11 

12 . 

IINT 

CCLK 

.13 

14. 

MRST 

HLDA 

.15 

16. 

HLDO 

IACK 

.17 

18. 

CDET 

10M 

.19 

20. 

A19 

A18 

.21 

22. 

A 1 7 

A16 

.23 

24. 

AIS 

A14 

.25 

26. 

A13 

A12 

.27 

28. 

All 

A10 

.29 

30. 

A9 

A8 

.31 

32. 

VRAM 

HLDI 

.33 

34. 

ALE 

GND 

.35 

36. 

NMIO 

OA7 

.37 

38. 

OA6 

OA5 

.39 

40. 

OA4 

OA3 

.41 

42. 

OA2 

OA1 

.43 

44. 

OAO 

ADO 

.45 

46. 

AD1 

AD2 

.47 

48. 

AD3 

AD4 

.49 

50. 

AD5 

AD6 

.51 

52. 

AD7 

EINT 

.53 

54. 

NRD1 

VEXT 

.55 

56. 

EACK 

BATD 

.57 

58. 

NWRI 

5VS 

.59 

60. 

BBUF 



2.6.2 Explanation of expansion pin names 


I^ 0 S 0 eC !0n explains the funct| ons of the expansion port. It assumes a knowiedge of 
öUOoo minimum mode, Detailed Timing for relevant Signals can be found in a 
microprocessor data sheet, ideaily OKI MSM8GC88ARS-2. 

REDY output 

This line indicates to the CPU that the custom Chip is ready This line is 
active high. 

VCC output 

This is the Credit Card power suppiy. 

BCOM output 

This is the Communications select fine, used for peripheral 
implementations. It is low if I/O locations 807X are being accessed. This 
Signal is active within lOOnS of I/O address being valid (see section 2,7). 

NCC1 output 

This is the external credit card chip select line. It is low if the external 
credit card is selected. See BCOM for timing. 

NMD1 input 

This is the external credit card detect line, It goes low to indicaie that a 
card is plugged in. 

DTR input/output 

This is the 80C88 data direction Signal. Düring CPU HOLD this line may 
be driven. 

DEN input/output 

This is the 80C88 data enable Signal. Low indicates a data cycle. Durina 
CPU HOLD this line may be driven. 

PDET input 

This is the peripheral detection line. It should be tied high on a terminating 
peripheral that has a PID. (See section 2.7 for more details.) 

IINT output 

This is the internal interrupt request line to the CPU (INTR), It goes high to 
indicate an interrupt request. 




IACK npul/output 

1 hts is the 80C88 Interrupt acknowledge line (INTA). It goes tow to 
request an Interrupt vector after an IfNT. Düring CPU HOLD it may be 
driven by external hardware. 

EINT input 

This is the externa! Interrupt request line. ft may be driven high by external 
hardware on a terminating peripheral to request an interrupt. This interrupt 
line has lower priority than the on board Interrupts. This Signal is level 
triggered. 

EACK output 

This is the external interrupt acknowledge line from the Portfolio. It goes 
low to request an interrupt vector after an EINT, it foilows \INTA on the 
processor, but is delayed by up to 40nS. 

CCLK output 

This is the main processor clock (4.9152MHz, 50% duty cycle). Since the 
clock pauses when no Processing is taking place, dynamic logic should 
not use this line. It may be used for synchronising peripheral logic. Düring 
halt mode this line is high. This Signal is only availabie to terminafinq 
peripherals. 

MRST output 

This indicates System reset. MRST will normally be high, except when a 
terminating peripheral is instalied. The terminating peripheral will experi 
ence a short reset when inserted. If a terminating peripheral is instalied 
then MRST goes high to indicate System reset. MRST will remain high at 
any time the reset key is pressed. it will also go high when the main 

Computer System powers up. Under these conditions MRST will remain 
high for over 300mS. 

HLDI input 

This is the hold request line and will drive HOLD on the 88C88. It may be 
driven high by external hardware to requisition the System bus. 

HLDO output 

This is the 80C88 hold request line (HOLD), HLDI should be used to 
request a HOLD. 

HLDA output 

This is the 80C88 hold acknowledge line (HLDA). It goes high to indicate 
that the bus is now free. This state will be called CPU HOLD. 
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WAKE input 

This line is used by a peripheral to wake up the main Computer when it is 
powered down. This line is set low to request wake up. Wake up can be 
confirmed by waiting tor a falling edge on MRST. It will take 3Ü0400mS 
for wake-up to be confirmed. When wake up is confirmed, the wake input 
should be released. 

CDET input 

This signal is tied low to indicate to the main Computer that an external 
credit card drive is present. 

iOM input/output 

This is the 80C88 memory access select line. If high then a I/O cycle is 
taking place, if low then a memory cycle. Düring CPU hold this line may 
be driven. 

VRAM output 

This is the RAM power suppiy. It will backup RAM when the batteries are 
removed, therefore any current taken from this line should be pAs. 

5VS output 

This is the switched 5V output. There are two 5VS lines, 

GND output 

Signal ground line. 

VEXT output 

This is the external power suppiy line. 

ALE input/oütput 

This is the address latch Signal from the CPU, It latches the address bus 
on its falling edge. Düring CPU HOLD this line may be driven. 

A8-A19 input/ouiput 

These are the upper pari of the address bus from the CPU. Düring CPU 
HOLD these lines may be driven. 

AD0-AD7 input/output 

These are the multiplexed address/data bus from the CPU. Düring CPU 
HOLD these lines may be driven. 

OAO-OA7 output 

These are the lower latched address lines. 



NRDI input/output 

This is the 80C88 \RD Signal. It goes low to indicate a CPU read cycle. 
Düring CPU HOLD this line may be driven. 

NWRI input/output 

This is the 80C88 \WR signal. It goes low to indicate a CPU write cycle. 
Düring CPU HOLD this line may be driven. 

BATD output 

This is the detect line for the batteries. It goes low it the batteries are 
removed without a power supply being present. This can be used to 
prevent accidental corruption ot RAM. 


ABUF/BBUF input 

These are insertion detection pins. A terminating peripheral should have 
these lines connected to the adjacent 5VS line. (See section 2.7 on 
peripheral design.) 


NMIO output 

This is the 80C88 non-maskable interrupt request line, 

2.6.3 Comparison between IBM and Portfolio expansion bus 


The IBM PC and Portfolio expansion buses are analogous; however. the 
implementation of these buses are very different, See the comparison below: 


IBM PC 

a) I/O is partially decoded. 

b) A0-A19 are latched address 

c) D0-D7 are butfered data 

d) IRQ2-IRQ7 are inputs to 
the interrupt Controller. 

e} IOR/IOW/MEMR/MEMW are 
MAX mode bus control Signals 

f) DRQ1-DRQ3/DACK0-DACK3/AEN/TC 
are DMA control Signals 

g) I/O CH RDY inserts wait 
States for slow i/O. 

h} ALE is address laich enable. 

i) OSC is 14.31818 MHz Clock. 

j) CLK is 4.77 MHz, 33% duty 
cycle clock 

k) IO CH CK 


Portiolio 

I/O MUST be fully decoded. 

OAO-OA7 are latched address A8-A19 are 
address lines DIRECT from the processor. 

ADQ-AD7 are multiplexed address/data iines 
DIRECT from (he processor. 

EINT/EACK ailow connection of peripheral 
wilh an interrupt Controller. 

NRDI/NWRI/iOM are MIN mode bus contro! 
Signals. 

No analogous Signals, however, enough control 
Signals exist to ailow DMA control on a peripheral. 

No analogous signal. 


ALE is address latch enable 
No equivalent signal. 

CCLK is 4.9152 MHz, 50% duty clock which halts. 


No signal. 
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TYP1CAL TERMINATING PERIPHERAL 
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2.7 PER1PHERAL DESIGN ISSUES 


There are two types of peripheral that can be connected to the Portfolio, These 
peripherals either continue the System bus ("Through Peripheral") or not 
( Terminating Peripheral ). Different considerations are required for designing these 
types of peripherals. Appendix C illustrates an example peripheral design. (See 
section 3.5 for Software issues.) 


2.7.1 Terminating Peripherals (see diagram) 

A peripheral of this type Signals its presence to the Portfolio by having PDET tied 
high. If PDET is high then the Portfolio expects to see a Peripheral Identifier(PID). 
This is read from I/O location 807Fh. The returned number must be in the ränge 
7Fh. Please note that identifiers under 40h and over 7Fh are reserved for use 
by DIP and must NOT be used by non-DIP applications. 

A read at I/O location 807Fh should NOT be used by any peripheral n ANY way 
other than as stated above. 

A terminating peripheral can have an expansion ROM which contains support 
Software for the peripheral. This eliminates need for Software to be suppiied 
separately, The Chip seiect for this ROM should be connected to NCC1, At various 
times during a boot sequence, the ROM will be checked for an identifier. If this is 
present then the Software contained on the ROM will be executed (See section 3 5 
for more details.) 

The Portfolio has only limited expansion bus buffering. To make best use of this the 
tollowmg rules should be obeyed. 

i) ABUF and BBUF should be tied to the adjacent 5VS lines. This will cause the 
processor to hold while a connector is half in. 

ii) Only OAO-OA3 should be used. BOOM should be used for higher addressinq on 
peripherals. 

Ü') Per ipherals using the externa! interrupt facility should be reset by MRST into a 
state where interrupts are disabled until the vectors are set up correctiy. This is to 
prevent spurious Interrupts occurring before the interrupt vector is set up. 



TYPICAL THROUGH PER1PHERAL 


BBUF 

ABUF 

&VS 

&VS 

POET 



SIGNAL TO LATCH ADO ON WRITE 
AT 807C. LATCHED VALUE CALLED ’D’. 






EXPANSION BUS 
(TOWARDS PORTFOLIO) 


EXPANSION BUS t 

<AWAY FROM PORTFOLIO) 




2.7.2 Through peripherals (see diagram) 

°o n nn h e e c !L P roth h p e ^V he 7 Stem bUS iS con,inued 80 that further peripherals can be 

of penpheräl n ordeftha. ,“ “T' 6 ' 3 mem ° ry expans i° n u ™' would be this type 
or penpheräl In Order that terminating peripherals will operate correctly the tollowinn 

pe“phe m Js nS Sh ° Uld bS ‘ aken in '° aC “ Unt when <^"8 Sh' 9 

the periphe?aL BUF Sh ° U ' d n °' be connecied ,0 5V S. but brought straight through 

^u 0 Ä”or“ d ° n PeriPh6ral ' Sh ° Uld bS bU ' ,ered be,dre ,hs 

perSeraf ° U ' d n °‘ ^ °° nnected ,0 SVS ’ but brought straight through 


the 


jy) The I/O looations 8070-807F should not be used so as to proyide compatibilitv 

pedphe^ s) 807 P Ch ran r h S USI h° ,heSB looations (such « DIP serial and parallel 
penpnerals/, 807Ch can be used as stated in vi) below. 

ll h ™ 9 n h ” P er 'P herals risk crashing the System bus as virtually no bufferinq exists 

1 th?P « r ? C °T ended that ,h6Se P ed Pherals are only inserted or removed 
from the Porifoho when powered down. removeo 

mrauohp^riphe^k 2 k BXten f dns on terminating peripherals function correctly 

.otorÄr fl :r con a memory card in,er,ace must supp,y io ® c *>»• 

expariskrn^o^t 0 '° ^ 807Ch Wi " CaUSe NCC1 ,0 be ‘-Oed Io ,he through 


* A wri te of one to I/O 807Ch will 
memory card interface. 


cause NCC1 to be directed 


to the peripheral 
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2.7.3 Allocation of Periphera! ID (PID) bytes 

The PIDs have currently been allocated as foliows: 


PID 

PERIPHERAL 

00h 

Communication Card 

01h 

Serial Port 

02h 

Parallel Port 

03h 

Printer Peripheral 

04h 

Modem 

05-3Fh 

Reserved 

40-7Fh 

User Peripherals 

80h 

File-Transfer Interface 

81-FFh 

Reserved 


For custom user peripherals a specific PID can be allocated by contacting the Atari 
Portfolio Product Manager in writing, describing the use of the peripheral. 





2.8 LCD Display 


The Portfolio uses a 240x64 pixe! LCD display which uses the "Super-twist 
Technology. This corresponds to 8 lines of 40 characters text display. 


The Circuit includes a graphics LCD screen Controller with dedicated screen RAM 
Chip ar) d cha racter set ROM, used in such a way as to be compatible as possible 

with an IBM Monochrome Display Adapter (MDA). (See section 3 7 for more 
details.) 


The LCD circuit has the following characteristics: 

* Full IBM PC Extended character set (see Appendix B) 

Virtual 80x25 MDA screen page with various screen modes 
PC-BIOS compatible pixel Set/Reset for graphics 

* Each character is implemented as an array of 6x8 pixels 

* Software controlled contrast 

* Block or underline Cursor 

Note Screen text attributes and various Cursor modes are not supported by the 

r-'f'iriTOi \\r\ * 
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3 SOFTWARE 


3.1 General Description 
3_1_1 OverView 

The Atari Portfolio Software is contained on ROM and predominantiy executes from 
ROM, and hence minimizes the use of RAM. This Software prcvides as much PC 
compatibility as possible given the hardware constraints. (See sections 3.2 and 3.4 
for BIOS and DOS comparisons.) 

This Software also includes some more advanced features which enable the 
Portfolio to be used more effectively in a portable environment than a Standard PC. 
Most of these Software features are accessed using Interrupt 61H, the Atari Portfolio 
specific functions. (See section 3.3,1.) 

To aid development of application Software for the Atari Portfolio which require the 
use of these specific functions there is a TSR (Terminate and Stay Resident) 
Emulator program for the IBM PC. This program emulates most of the functions, 
(See section 3,10 for more Information.) 


3.1.2 Portfolio Programming 

The Portfolio obeys iBM’s own programming guidelines for PC compatibility, 
however these are a iot more flexible than the industry-standard definition of a 
’clone' PC. 

Most ’weli-behaved’ PC programs run with no problem on the Portfolio, provided 
that they do not go below the BIOS to directly use the hardware. The main 
development issues are the screen size and memory capacity. Below are the 
various points to take into consideration when developing a program for the 
Portfolio, 

SCREEN - (See also section 3.7.) 

The Portfolio has a 40 column by 8 line texf display which uses Video RAM af the 
same address as the PC Monochrome Display Adaptor (MDA) and uses the same 
character set. However the Portfolio LCD Controller does not support text attributes 
such as bold, underline and reverse or the various Cursor sizes. If you want to use 
the Portfolio graphics facitity then use the Standard BIOS pixel read and write 
interrupt. 
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MEMORY - (See also section 2.2.) 

The Portfolio has an internal memory disk C: which can be configured in'8KB 
intervals. minimum 8KB. This ieaves a maximum of 116 KByte usable RAM ot which 
10 KBytes are used by the operating System and BIOS, Therefore it is recommended 
that programs should not use more than lOOKBytes of System RAM. If you want to 
use the builHn 'pop-up' applications with the external program then allow for some 
free RAM (minimum of 17 KBytes). 

MEMORY CARDS - (See also section 3.6.) 

These memory cards appear to a DOS program !ike a Standard floppy disk. The 
Portfolio has DOS resident all of the time and therefore does not need to boot from 
a disk. If you want to automaticaliy boot into a program then you can put 
AUTOEXEC.BAT on a memory card, overriding C:\AUTOEXEC. 

RS232/SERIAL - (See also section 4.1.) 

The only compatible method for accessing the serial port is through the BIOS. 
However most off-the-shelf serial programs go directly to the hardware. 

KEYBOARD- (See also section 3.2,1.) 

The Atari Portfolio supplies full IBM PC scan-code compatibility provided access is 
through the BIOS, in other words it is possible to generate every keypress or 
combination that a Standard PC can generate (SHIFT, CTRL. ALT, NUM PAD). It is 
also possible to generate other non-PC key combinations necessary for functions 
such as contrast and switching off. 

POWER - (See also section 3.8.) 

For power Conservation, it äs recommended that programs are designed which do 
not poll the keyboard continuousiy. 

ADVANCED 

There are also more advanced features which enable custom programs for the 
Portfolio to perform more sophisticated tasks, such as running programs directly 
from the memory cards (section 3.6), peripherals with builHn Software on ROM 
(section 3.5), language Information and access to the built-in tone dialler. 


3.1.3 Troubleshooling 

Running well-behaved Standard off-the-shelf PC Programs: 

* Make stj re that the DISPLAY SETUP (see user manual) is set to Static PC for 
Externa! programs. 

* If the program writes directly to Video RAM then ensure that DISPLAY REFRESH 
is set to KEYBOARD or FAST TIMED, whichever is more appropriate. 

* Endeavor to allocate enough System RAM, 

Although many populär programs are 'well-behaved’ there are also many programs 
which directly address the hardware. This can cause a problem on the Portfolio as 
the IO addresses are different. The most common of these incompatibilies occur 
with the keyboard and hardware interrupts. The Portfolio does not have a 
Programmable Interrupt Controller (PIC) or a dedicated keyboard Controller, 
therefore some programs which access these such as Basic and XTALK will not 
function correctiy. The Portfolio also uses a different Timer Tick than a PC which 
affects some 'dirty' programs such as Sidekick. Another hardware area that differs 
on the Portfolio is the use of the Speaker, which should be accessed using the 
BIOS. 



3.2 Djfferences Between Portfofio BIOS and IBM PC BIOS 

For the purposes of this document, Portfolio BIOS is defined as the progfam which 
communicates between the DOS and the hardware. (See recommended books in 
section 1 for more information on the Standard PC BIOS.) 

There are a few differences between Portfolio BIOS and the Standard IBM PC 
BIOS. These are generally in areas where the hardware differs to such an extent 
that compiete compatibiiity is unobtainabie. For example, in the Video Services (Int 
10H) the Portfolio only has two screen modes; 80 by 25 Text and 240 by 64 
Graphics, 

3.2.1 Interrupt differences 

The following [ist highlights the rriain differences between the DIP BIOS and IBM PC 
BIOS: 

Int 09H ’ Keyboard 

The Portfolio keyboard is not at the same IO address as a Standard IBM 
PC, therefore any program which requires the keyboard to be at port 60H 
will not work correctly. 

Int 10H Video Services 

Service 00H, Mode 07 to OAH are supported, but only in Text or Graphics 
mode. Service 01H, Cursor size is set to either block or u/line. (See 
section 3.7.) 

Int 13H Disk 

The Portfolio has modified Memory Card/Disk Services 0 to 05H and 83H. 
(See section 3.3.2 for more details.) 

Int 15H Extended 

No Extended Services are available. 

Int 16H Keyboard 

Only Service 0, 1, 2, 4 are supported. 

Int 18H BASIC 

Not supported. 

Int IAH Clock 

Only Services 0-07H supported. 

Int ICH Timer tick 

tnvoked less frequently than IBM PC (see section 3.3.1). 
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3.2.2 Portfolio BOOT proceduie 


On a COLD boot (batteries removed, COLD Reset switch pressed, then batteries 
replaced), the BIOS executes a limited Power On Seif Test (POST) to verify System 
integrity. This will destroy data in System memory (both programs in the Transient 
Program Area and those on internal drive C:). The Portfolio System then performs 
BIOS and DOS initialization before jumping to the COMMAND processor. This will 
always reset the machine unless there is a hardware fault. 

On a Hardware WARM boot (WARM Reset switch pressed or batteries replaced 
without pressing the COLD Restart switch), the Portfolio performs BIOS and DOS 
initialization before jumping to the COMMAND processor. 

On a Software WARM boot (Ctrl-Alt-Del on Keyboard), the sequence of operations 
is similar to those for a Hardware warm boot. The difference between the two is that 
a Hardware warm boot also resets the ASIC and Processor which may be 
necessary if the interrupts have been disabled because the keyboard will not 
recognize user key presses. 





3.3 System Specific BIOS 


3.3.1 Int 61H - DIP extended BIOS Services 


Function 

Description 

OH 

Service Initialization 

7H 

Format Credit Card Memory (CCM) 

8H 

Get size of Internal disk 

9H 

Format Internal disk 

BH 

Determine if CCM present 

DH 

Get Screen size 

EH 

Get/Set Screen mode 

FH 

Get/Set Cursor mode 

10H 

Get/Set virtual screen Position 

11H 

Move virtual screen Position 

12H 

Screen refresh 

15H 

Sound generation 

16H 

Melody tone 

17H 

Dial number 

18H 

Mute States 

19H 

Get Serial port Parameters 

IAH 

Get Peripheral ID byte 

1 BH 

Set Peripheral ID byte 

ICH 

Preset Peripheral IO data 

1EH 

Get/Set Clock tick speed 

1FH 

Get-key/Tick Screen refresh 

20H 

Disable revectoring of Int 9H 

24 H 

Get/Set ROM space state 

26H 

Get/Set Power State 

28H 

Get/Set Language 

2CH 

Get BIOS Version number 

2DH 

Turn system off 

2EH 

Enable/Disable Status line 

30H 

File transfer via smart cabie 


Note: There are other reserved Int 61H Services which are used internally by the 
Operating System. It is not recommended that these Services are invoked by 
applications Software, as they may be modified or deleted in tuture versions of the 
Software. 


Fn OOH Service Initialization 
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Parameters: 

AH OOH 

Returns: 

None 

Note: This Service should be called once only as part of its initiaiization by any 
application program that intends to use any Int 61H function calls. 

Fn 07H Format Credit Card Memory 2.3, 3.6, 3.32 

Parameters; 

AH 07H 

AL Drive number (0 or 1) 

Returns: 

CF Set if error during format 

AH Error code (See INT 13H) 

Note: Drive number 0 selects drive a| and drive number 1 seiects drive B:. This 
Service should not be used to format the internal disk (drive number 2). 


Fn 08H Get size of Internal disk 3.3.2 

Parameters: 

AH 08H 

Returns: 

AX Segment Address of disk 

BX Size of disk in Kbytes 


Fn 09H Format Internal disk 3.3.2 

Parameters: 

AH 09H 

BX Size of disk in Kbytes 

Returns: 

If CF=1 

BX Maximum size possible (K) 


Note: The System is rebooted if successful. All files on drive C: will be lost 



Fn OBH Determine if CCM present and valid 2.3. 3.3.2, 3.6 

Parameters: 

AH OBH 

AL Drive number (0 or 1) 

Returns: 

CF=0 Card present and correct 

ifCF=1 

AH Error Code (See Int 13H) 

Note: This can be used to determine if a valid CCM is in the specified drive. Drive 
number 0 selects drive A:, and drive number 1 selects physical drive B:. 


Fn ODH Get screen size 
Parameters: 


Note: 


AH 

ODH 

o. 

AX 

Physical screen size 

DX 

Logical screen size 

AH/DH 

Row number 

AL/DL 

Column number 


2.8. 3.7. 2.1.4 


Fn OEFI Get/Set screen mode 


Parameters: 

AH OEH 

AL=0 Get mode 

AL=1 Set mode 

DL New mode 
Returns; 

If AL=0 

DL Mode 

If AL=1 

DL Old mode 


2.1.4. 2.8, 3.7 


Note, The mode is changed by setting one of the following mode bits in DL: 


Clear bits (GQH)80 by 25 mode 
bit 0 (01H) 40 by 8 mode 
bit 1 (02H) Tracked mode 
bit 7 (80H) Graphics 

These bits are mutuaily exclusive. When changing to 40 by 8 mode, if the 
Cursor Position or virtual screen origin is off the screen, then the virtual 
screen origin will be set to (0.0), the Screen cleared and Cursor homed. 


Fn OFH Get/Set Cursor mode 


Parameters: 


AH OFH 

AL=0 Get mode 

AL=1 Set mode 

BL New Cursor mode 

AL=2 Force mode 

Returns: If AL= 0 

BL Cursor mode 
If AL> 0 

BL Old Cursor mode 

Note: Cursor mode is as foilows: 

0 Cursor off 

1 Underline 

2 Block 


Force mode automatically sets the BIOS Cursor size to reflect the Keyboard 
Numlock state. 


Fn 10H Get/Set virtual 


screen Position 


2.1-4, 2.8, 3.7 


Parameters: 


AH 

10H 

AL 

0 Get position 

AL 

1 Set position 

If AL=1 


DH 

Row number 

DL 

s: 

Column number 

If AL=0 


DH 

Row number 

DL 

Column number 


Note: The virtual screen position is the top left origin of the 40 bv € 
logicaf screen. y 


Fn 11H Move virtual screen Position 

Parameters: 

AH 1 ih 

AL Number of lines to move Cursor 

DL Direction to move Cursor 

1 Up 

2 Down 

3 Left 

4 Right 

Returns; 

None 


2.1.4, 3.7 


NOte: TL i . S 7T 0 . VeS the 0r ' 8in °' the vir,ual screen with 'n scroll margir 
in Slatic or tracked mode, and has a similar effect to pressin 
Cursor keys. 


Fn 12H Screen refresh 

Parameters: 

AH 12H 
Returns: None 


2.1.4, 2.8, 3.7 


Note. This Service copies the contents of the Video RAM to the LCD 
and is slightfy faster than invoking Int 10H Service 0. 


window on the 


. It only works 
I the Alt¬ 


controller, 






Fn 15H Sound generation 

Parameters: 

AH 15H 

AL Sub Service: 

0 Key-ciick 

1 Beep 

2 Alarm 

Returns: 

None 


Fn 16H Melody tone generator 


Parameters: 

AH 16H 

CX Length of tone in 10 mSecs intervals 

DL Tone code (See below) 


30H 

D#5 

622.3 Hz 

31H 

E5 

659.3 Hz 

32H 

F5 

698.5 Hz 

33H 

F#5 

740.0 Hz 

34H 

G5 

784.0 Hz 

35H 

G#5 

830.6 Hz 

36H 

A5 

880.0 Hz 

37 H 

A # 5 

932.3 Hz 

38H 

B5 

987.8 Hz 

39H 

C6 

1046.5 Hz 

3AH 

C#6 

1108.7 Hz 

29H 

D6 

1174.7 Hz 

3BH 

D»6 

1244.5 Hz 

3CH 

E6 

1318.5 Hz 

3DH 

F6 

1396.9 Hz 

OEH 

F#6 

1480.0 Hz 

3EH 

G6 

1568.0 Hz 

2CH 

G#6 

1661.2 Hz 

3FH 

A6 

1760.0 Hz 

04H 

A*6 

1864.7 Hz 

05H 

B6 

1975.5 Hz 

25H 

C7 

2093.0 Hz 

2FH 

C»7 

2217.5 Hz 

06H 

D7 

2349.3 Hz 

07 H 

D#7 

2489.0 Hz 


Returns: 

None 


Fn 17H Dial number 
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Parameters: 

AH 17H 

DS:SI String of characters 
CX Length of string 

Returns: 

None 

Note; String to be in ASCII. Valid characters are: 01 23456789ABCD* 4 * 
Leiters must be in upper case. 


Fn 18H Mute States 

Parameters: 

AH 18H 

AL 00 

01 
02 
03 
04 
05 
06 
07 
08 
09 


Get mute state 
Set mute state 
Get key click state 
Set key click state 
Get bleep state 
Sei bleep state 
Get alarm state 
Set alarm state 
Get DTMF duration 
Set DTMF duration 

1, 3, 5, 7 or 9 
0 Off (Muted) 

1 On 

0, 2, 4, 6 or 8 
0 Off (Muted) 

1 On 


ff AL = 
DL 

Returns: 

If AL = 
DL 
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Fn 19H Get Serial port Parameters 2.7, 4.1, 3.5 

Parameters: 

AH 19H 

DX Serial port number 

Returns: 

If AH=0, Composite Parameters in AL 
If AH<>0, Error 

Note: This Service returns composite Parameters identical io those üsed by Int 14H 
Service 0 Onitialize). 


iW»1 


m y 

5 ^ 


Fn IAH Get Peripheral ID byte 2.7, 3.5 

Parameters: 

None 

Returns: 

AH Peripheral ID byte 

AL 0 if no peripheral installed 

Note: This returns the peripheral ID code for the current terminating peripheral 
(SeeFnIBH.) “ ' 


Fn 1BH Set Peripheral ID byte 


2.7, 3.5 


Parameters: 

AH 

AL=0 

AL=1 

DL 

Returns: 

None 


1BH 

Set Serial ID 
Set Parallel ID 
Current peripheral ID 


Note: There may be peripherals designed that contain circuitry that is similar to the 
Serial or Parallel peripherals. In order that these peripherals may use existing 
BIOS Services they must identify themselves as being Software compatible, 
DL should be set to the Peripheral ID code. {See Fn IAH.) 


Fn ICH Preset/Return Peripheral data 


2.7, 3.5, 4.1 


Parameters: 

AH 

AL=0 

AL=1 

BH 

If AL-G 

BL 

DX 

Returns: 

If AL=1 

BL 

DX 


ICH 

Preset Data values 
Return Data values 
Table entry number 

Data value 
10 address 


Data value 
IO address 
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ote. This Service is used to preset peripheral iO data in a table associating an (O 
address with a data value. Service 0 will actually output the data to the 
specified IO locations. On Power-up, the table entries will be scanned for 
non-zero IO address values, and the associated data will be wrilten out. This 
would typically be used to restore Interrupt numbers following Power-up. The 
tirst tour table entries out of 10 max are reserved. 


Fn 1EH Get/Set Clock lick speed 


Parameters: 

AH 1EH 

AL Subservice 

0 Get speed 

1 Set speed 


Jf AL = 1 
BX 


Returns: 

If AL 
BX 



Clock tick speed 
0 Tick every 128 seoonds 

1 Tick every second 

Clock tick speed 
0 Tick every 128seconds 

1 Tick every second 


2.4, 3.8 


Note: 


1 sec speed uses much more power. 


Fn 1FH Get key/NMI invoked screen retresh 2.8. 3 7 3 8 

Parameters: 

AH 1FH 

AL=0 Get retresh state 

AL= 1 Set retresh state 

If AL=1 

DX New state 

Returns: 

If AL^O 

DX Current state 
If AL=1 

DX Otd state 

Note: 

DH Retresh on NMIs state 

DL Retresh on keys state 

DH/DL=0 Revectoring disabled 
DH/DL=1 Revectoring enabled 

If bit 7 of the state is set, then the state is unchanged. 


Fn 20H Disable revectoring of Int 9H 

Parameters: 

AH 20H 

AL=0 Get revectoring ot Int 9H state 
AL=1 Set revectoring of Int 9H state 

H AL=1 

DL=0 Disable revectoring 

DL=1 Enable revectoring 

Returns: 

If AL=0 

DL=0 Revectoring disabled 

DL=1 Revectoring enabled 
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Note: I nis is used to automatically revector Int 9H to the BIOS. This prevents 

applications Software from setting up its own Int 9H. Note that the Portfolio 

keyboard IO address is not IBM compatible. This Service is automaticallv 
invoked on a boot 


Fn 24H Get/Set ROM/CCM space siate 


2.2.4 


Parameters: 

AH 24 H 

AL=0 Get ROM state 

AL=1 Set ROM state 

!f AL=1 

DL New ROM state 

DH New CCM state 

Returns: 

If AL=0 

DL Current ROM state 

DH Current CCM state 

If AL-1 

DL Old ROM state 

DH Old CCM state 

Note: ROM state in DL is as toliows: 

DL=Ü Normal applicaiions ROM 
DL=1 CCM Drive A: 

DL=2 CCM Drive B: 

DL=3 Expansion ROM 

CCM state in DH is as follows: 

DH=0 CCM Drives Disable(d) 

DH=1 CCM Drive A: Permanently enable(d) 

DH=2 CCM Drive B: Permanently enable(d) 

CF=Ü No error 

CF=1 Invalid option or error 

Note: This Service should be used with care, as it can swap either Memory cards 
or an extension ROM into the C000:0 to 0DFFF:F address ränge. This ränge 
is normally used by the internal applications ROM. Its primary use is to allow 
advanced users direct access to extension ROMs and Memory cards. 


XXXXXXJddJ.HlAvUJ. 


Fn 26H Get/Set Power control 


2.1.10, 2.5, 3.8 


Parameters: 

AH 26H 

AL=0 Get Power control state 

AL=1 Set Power control state 

If AL=1 

DL New state 

Returns: 

if AL=Q 

DL Current state 

ff AL=1 

DL Old state 

Note: 

DL=0 Normal Power-down on low battery 
DL=1 Prevent Power-down but display warning 
DL=2 Prevent Power-down with no warning 

This is used to prevent the Portfolio from powering down on a low battery. 

It is not recommended for use except for conditions in which a power down 
might be critical to an application or peripheral. 
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Fn 28H Get/Set Text/Keyboard language 

Parameters: 

AH 28H 
AL~0 Get Languages 
AL=1 Set Languages 
AL=3 Language table pointers 

If AL=1 

DX New languages 
Returns: 

if AL=0 

DX Current languages 

lfAI_=1 

DX Old languages 
If AL=3 

ES:CX Keyboard table pointer 
ES:DX Language table pointer 

Note: DH Text language 

DL Keyboard language 

Both DH and DL will be 0, 1 or 2, corresponding to the language in the 
ROM. 

If bit 7 of the language/keyboard code is set, then it remains unchanged. 

The tables consist of a count byte, foilowed by the language identifioafion 
codes for the resident languages. These are as follows: 

ENGLISH 0 

FRENCH 1 

GERMAN 2 

SPANISH 3 

ITALIAN 4 

SWEDISH 5 

DANISH 6 


Fn 2CH Get BIOS Version number 


Parameters: 

AH 2CH 
Returns: 

DS:BX Address of BIOS Version number 

Note: The Version number consists of a Major and Minor Version number, followed 
by a ’$’ terminator. A typical example is: '1.050$' 


Fn 2DH Turn System off 2.1.10 2 5 3 8 

Parameters; 

AH 2DH 
Returns: 

None 

Note: This is similar to typing OFF at the command line. 


Fn 2EH Enable/Disable System Status line 


Parameters; 

AH 

AL=0H 
AL= 1H 


Returns: 

None 


2EH 

Disable status line 
Enable status line 
DH Row number 
DL Column number 


Note: This is similar to invoking the status line using the LOCK key. 



Fn 30H File Transfer Services 


4.2 


Parameiers: 

AH 30H 

AL 0 Transmit block 

1 Receive block 

2 Open ports 

3 Close ports 

4 Wait 500mS 

DS:DX Start of Data butter 

If AL= 0 

CX Bytes to Send 

If AL= 1 

CX Maximum butter size 

Returns: 

If AL=1 

CX Bytes Received 

DL Error Code 

0 No error 

1 Buffer size too small 

2 Timeout on transmlssion ; 

3 Checksum failure 

4 Invalid sub-service 

5 Peripheral not installed 

Note: This is used by the File Transfer Utility built into System Setup. 

3.3.2 Disk Services 

The Portfolio Credit Card Memory (CCM)/Disk Services are provided at the BIOS 
level by Int 13H. 

There are six Standard diskette sub-services. plus one special Service These are 
below: 

OH Reset CCM/Disk System 

1H Get CCM/Disk Status 

2H Read CCM/Disk sectors 

3H Write CCM/Disk sectors 

4H Verify CCM/Disk sectors 

5H Format CCM/Disk track 

83H Write CCM/Disk bootsector 


as 


Services 0 to 4 are similar to Standard IBM PC BIOS disk Services. They can access 

the three internally supported disk drives A. B and C (referred to as drives 0 1 and 
2 respectiveiy). 

Int 13H uses the BIOS Parameter Block (BPB) on the Boot sector (first sector) of 
the dnve to determine the drive characteristics. Düring formatting. it is necessary to 
use a Format BPB, which is supported by Service 83H. This Service is used instead 
of Service 5H to format the first track of a CCM/Disk. 

The Parameters to Service 5 are unlike those on a normal PC as detailed below: 


Int 

13H Fn 5H 

Parameters: 


AH 

5H 

DL 

Drive number 

DH 

Side/Head 

CH 

Track number 

Returns: 


CF=1 

Error code in AH 


Note: Writes defined byte onto one track of CCM. Byte is 
specified in the Disk base table. 

The Disk base table is similar to that used by an IBM PC. The table for both CCMs 
is pointed to by Interrupt 1EH, and the table for the internal disk is pointed to by 

Interrupt 41H. The format of both disk base tables is as below: 

Offset 03H Bytes per sector code (0=80H, 1 = 100H, 2=200H) 

Offset OAPt Format data bytes (Normaily FSH) 

Düring formatting using Interrupt 61H (see section 3.3.1), the CCM/Disk sector size 
is dynamically set according to the disk size. See below: 


Disk size 


Sector size 


0 to < 32 Kbytes 80H/128 bytes per sector 

>32 to <=64 Kbytes 100H/256 bytes per sector 

>64 Kbytes 200H/512 bytes per sector 

This ensures that a small disk size ailows a reasonable number of sectors Since 
Port olio DOS allocates one sector per data ciuster, this ailows the same number of 
small data tües on a 32K CCM as a 128K CCM 
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There are various 
3.3.1.): 

Int 61H Fn 7H 
Int 61H Fn 8H 
Int 61H Fn 9H 
Int 61H Fn OBH 


Int 61H Services that provide extended disk Services (see section 
Format a CCM 

Get the size of the Internal Disk 
Format the Internal disk 
Determine it a valid CCM is present. 


Note. A CCM may also contain a BIOS extension which does not affect the 
Operation of the CCM, but can modify the Operating System or Power-down/Power- 
up sequence. (See section 3.5.) 
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3.4 Differences Between Portfolio DOS and MS-DOS 

For fhe purposes of this manual, Portfolio DOS is defined as the prograrrt which 
communicafes between the Command processor or User applicaiion, and the BIOS. 
It does NOT include the Command processor. (See recommended books in section 
1 for more Information on the Standard MS/PC-DOS.) 

There are a few differences between Portfolio DOS and MS-DOS. These are mainly 
enhancements to Portfolio DOS 2.11 to make it more DOS 3.XX compatible; 

Int 21H Fn 37H Get/Set Country 

Portfolio DOS is DOS 3.XX compatible 

int 21H Fn 4BH Execute program 

As well as providing Standard EXEC Services it also allows a program to be 
RUN directly off a CCM (section 3.6,3). 

Int 28H Keyboard busy 

Not supported. This would normally be cailed during console IO polling, 
however Portfolio DOS does not poll the console, but actualiy waits for a 
key using Int 16H Fn OH. (See section 3.8 on power management.) 

Int 2AH Internal MS-DOS function not fully supported 



3.5 Device Drivers and Peripheral Software 
3.5.1 Device Drivers 

Device drivers are used by DOS to communicate with the BIOS. They provide a 
Standard interface which isolates the DOS from the device specific BIOS. The 
Portfolio has the following resident device drivers in ROM: 

CON, CLOCK$, PRN, LPT1, AUX, COM1 and Disk driver 

CON performs all Console IO 

PRN/LPT1 perform all Parallel (Printer) IO 

AUX/COM1 perform ali Serial IO 

CLOCK$ special driver to access the BIOS Clock 

These are all character devices that process strings of characters one character at a 
time. They are all identified by their names. 

The Disk device driver is a Block device which requires all IO to be done in blocks, It 
addresses all the normal Portfolio disk drives (A, B and C). 1t has no name. 

It is possibie to replace these resident device drivers (and add new ones) by the use 
of installable device drivers. These may be loaded by DOS using the ’DEVICE- 
command in CONFIG.SYS. If a character device is loaded that has the same name 
as one of the above device drivers, then it replaces it. This mechanism is used by 
programs such as ANSI.SYS which is actually a CONsole device driver with added 
features. 

if a Block device driver is added, it Supplements the existing Disk device driver. An 
example of this is the Virtual disk driver VDiSK.SYS, which would add drive D:. 

The structure of an installable device driver is compatible with any MS-DOS 2.11 
device driver. 




3.5.2 Peripheral Design 

There is a special design issue associated with Portfolio peripherals, due-to the 
Portfolio auto power-down power Conservation feature. This means that most 
peripheral devices will need to be re-initialized on power-up. (See Appendix C for 
more information.) 

There are two methods provided to fulfill this requirement: 

1) Int 61H Fn ICH 

This service stores a list of IO addresses and associated data values, which will be 
output on a power-up. If all initialization specific fO writes are made via this Service, 
then they will automaticaliy be repeated on all power-up sequences, 

A typical use for this Service might be to restore an interrupt number in an interrupt 
driven serial peripheral. 

2) Use a ROM extension. This would generaily be required when the sequence of 
operations during power-up could not be supported by the Int 61H service. This will 
require the peripheral to contain an extension ROM. (See 3.5.3.) 

There are two exceptions to the above. The serial port Parameters are read during 
the power-down sequence and correctly re-programmed on the subsequent power- 
up, The Parallel port is also initialized on Power up. 

Each peripheral is identified to the Portfolio by its Peripheral ID code (PID) (see 
section 2.7). This is actually a hardware IO location on the peripheral which may be 
read using Int 61H Fn IAH. 


The other Software issue associated with custom peripheral design concerns the 
Serial or Parallel peripherals. if the custom peripheral wants to use existing BIOS 
Services then they must identify themselves as being hardware compatible: 


Int 61H Fn 1BH configures the BIOS to recognize a peripheral to be Serial or 
Parallel compatible. 


3-5.3 ROM Extensions 


the Bon? «« sec ' lons 01 code ,hat can be executed at various stages during 

rrp^Pr K? nCe vS nd durin0 Power U P and Power Down. They may be on a 
edit Card Memory (CCM) or on a extension ROM on a peripheral. A typical use pf 

an ex ension is to modify the operating System or initialize custom peripherals. 


noTlwf three m “ n ' ypes extens ions: A Specific BIOS extension, a Speoific 
DOS extension, and Common extensions: 


* Th! Q pec " c 5^0 extension ts invoked after BIOS initialization 

* Th ^ pectf,c DOS ex tension is invoked after DOS initialization 

I he Common extension is invoked before and after both BIOS and DOS 

p"p° n ' 8 C ° mmand Pr0 ° eSSOr ini,ia ' iZa,i0n and d ^i b a Power Down and 


then Driv M e B Drive A ' then ,he Pension ROM 

oartcu Ir 4 d extenslon ls fou nd and executed, then the search for 
particular type of extension is terminated. 


and 

that 


The format of a ROM/CCM extension is as follows: 


Offset Size 


OOH 

dw 

? 

02H 

db 

? 

03H 

db 

5 dup (?) 

40H 

db 

'DIP ROM! 

50H 

db 

5 dup (?) 

55H 

db 

5 dup (?) . 

5AH 

db 

5 dup (?) 

5fH 

db 

5 dup (?) 

64H 

db 

5 dup (?) 

69H 

db 

5 dup (?) 

6eH 

db 

5 dup (?) 


Identification code 
iNumber of 512 byte 
;blocks(unused) 
iSpecific BfOS/DOS exten 
;OEM user text 
;Pre-bios jmp vector 
;Bios-ext jmp vector 
;Pre-dos jmp vector 
;Dos-ext jmp vector 
iPosEdos jmp vector 
;Power-Down jmp vector 
;Power~Up jmp vector 


Ino 6 T Xte ü S ' 0n VeCl ° rS occupythe first 128 bytes of the CCM/ROM. The vectors are 
p loned so as to allow a valid BIOS Parameter Block (BPB) on a CCM so that it 

o se, e 0 U de e t d erm!ne s S ,h n ° CM a " d 35 nor ™'' '*n«Ä Code* 

61 u determines the main extension type as below: 


AA55H 

55AAH 

5555H 


Specific BIOS extension 
Specific DOS extension 
Common extensions 






Thus, if the Word ai Offset 0 is AA55H, then after BIOS initialization a FAR CALL will 
be made to Offset 3. The 5 bytes following this offset alfow for a short/normal/far 
jump to the extension code. If the word was 55AAH, the call would be made after 
DOS initialization, If the word is 5555H, then all the common extensions would be 
called at the appropriate times. 

Note: All the jump vectors must be set up to a suitable return when using a 
common extension, even if they are not used. 

All ROM extensions must preserve the processor registers. Extreme care must be 
taken when using extensions, especially those which are invoked half way through 
the boot sequence, as these may adversely affect the Operation of the Portfolio. The 
Pre-BIOS extension is called almost immediately on jumping from the Reset vector, 
and so has no stack set up. It must return via a FAR JUMP to GFFFE:0H. All the 
other extensions must return via a FAR RET. It is recommended that the Post-DOS 
extension is used in preference to those preceding it. 

The OEM user iext field at Offset 40H is to allow an OEM to identify the ROM. 

See Appendix C for examples of using an Extension ROM. 
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3.6 Memory Cards 
3.6.1 Format 

Each credit card memory (CCM) must be fomnatted betöre use, this program 
creates a formal analogous with a Standard floppy disk format. 

All fomnatted memory cards contain only 1 sector per duster as opposed to ihe 2 or 
more found in larger Systems. (See section 3.3,2 for more details.) 

The Atari Portfolio BIOS has been written to handle.futurepaged Credit Card 
Memorles (CCM). The BIOS assumes that the page register, is one byte located at 
offset 10 (OAH) within the Boot sector (First sector) of the Memory card. For this 

reason DO NOT use this memory location in programs. 


3.6.2 Autoboot Mechanism 

The Portfolio has the ability to invoke AUTOEXEC.BAT from drives other than drive 

C:. .,.■■■■ 

If a memory card is in drive A: or B: and AUTOEXEC.BAT file exists, it is executed 
in preference to autoexec on C:. B: will have priority over A: if an AUTOEXEC BAT 
exists on both A: and B:. 

If it is required that the AUTOEXEC.BAT on drive C: is always executed. terminate 
the batch file on drive A: with the command: 

C:AUTOEXEC 

The CONFIG.SYS file is always loaded from drive C: and cannot be overridden. 


3.6.3 Run 

A RUN file is a specially written program that can be directly executed from a Credit 
Card Memory (CCM) without having to be loaded into the Transient Program Area 

(TPA). An obvious advantage of this method of execution is that it minimizes system 
memory usage. 

A RUN file can be executed from the Command processor by typing RUN 
<filename>, or by invoking Int 21H Fn-4BH at the DOS level as for a normal 
program, but wiih AL set to 80H. 








There are several requiremenls for Ihe programs which can use the RUN command: 


* The program needs to be specially written to be used with the RUN command. 

* The program needs to be on drive A: or drive B: and il needs to occupy 
consecutive clusters on the disk. This Situation cannot be guaranteed if a file is 
simply copied to the drive. 

* The file needs to have a .RUN extension. 

Writing .RUN Programs 

Aimost all Standard programs assume either that their data is in System RAM, or that 
they can störe data in their code segment. Although a .RUN file is similar to a .COM 
file, care should be taken when dealing with data. 

The initialization code ot the .RUN program has to perform the following (these 
points are illustrated in Appendix A): 

Reduce the System memory usage down to the minimum requirement. There must 
be at least 10h paragraphs, i.e. the size of the PSP. 

* Allocate data and stack using DOS interrupt 21h fn 48h and set ss:sp to point to 
this block. 

* c °Py all initialized variable data from the memory card to the allocated data block 
in system RAM. 

* The program can then perform most functions it wishes to, including any DOS 
calls. The program MUST terminate with DOS interrupt 21h function 4Ch 
"terminate process". 

* The program does not need to copy the nomvariable (constant) data from the 
ROM card into RAM before using it. This data can be used directly from the card. 
This means prompts or text messages need not take up any RAM. 

The built-in applications can be invoked while a program is being RUN using the hot 
keys as usual. 


If during execution of a RUN file the Credit Card Memory (CCM) is removed from 
the drive, the next instruction to be executed on the card will be interrupted by an 
error handler. This displays the error message: ’ERROR: Card Access' and 



3.7 Screen Handling 


The Portfolio BIOS supports two main Video modes, Text and Graphics. The BIOS 
Video Interrupt 10H may be used to sei the screen mode: 


Mode 

Type 

PC Resolution 

Portfolio 

Mode 7 

Mode 8 

Mode 9 

Mode A 

Text 

Graphics 

Graphics 

Graphics 

(80,25) 

(160,200) 

(320.200) 

(640.200) 

<80,25> 
<240,64> 
<240,64> 
<240,64> 


As can been seen, the Portfoiio interpretations of these modes is fairly simple, 

The Text modes are actually viewed using a 40x8 window, There are 3 subrnnodes' 
Static PC, 40x8 and Tracked. 

Static PC mode is where the physical screen area acts as a window onto the larger 
80x25 text screen, The window may be moved using the AiPCursor keys or int 61H 
Fn 11H. 

40x8 mode actually sets the logical screen size to 40 columns by 8 rows. This mode 
is intended for use by Software written specifically for the Portfolio, such as the the 
Command processor and the Internal applications. 

Tracked mode is similar to static mode, except that the Screen window positions 
itseif at the Cursor, 

This mode can be set using Int 61H Fn 0EH. 

The Video RAM (VRAM) for the text screen is at segment 0B000H therefore it is 
possibfe to write directly to the Video RAM, but any screen retreshing must be 
invoked by the application. There is only one text page. 


There are other Int 61H Video Services: 


Int 61H Fn 0DH 
Int 61H Fn 0FH 
Int 61H Fn 10H 

Int 61H Fn 12H 


Get the logical and physical screen sizes 
Set Cursor size 

Set the virtual screen window origin 
on the 80 by 25 screen 
Force a screen refresh 


in Graphics mode, the Graphics screen has a 240 by 64 pixel resolution and can be 
written to or read from using BIOS pixel read/write Int 10H Fn OCH or Fn 0DH 
respectively. The Atari Portfolio has three Cursor modes: Block, Underline and Off. If 
the Cursor size is set In the BIOS then either Block or underline mode will be set up. 



3.8 Power Management 


The Portfolio is designed Io minimize power consumption and hence maximize 
baftery life. This is reflected in the hardware design, buf is enhanced by various 
Software fealures. 

The main power wasting Operation in most Computers is waiting for user entry at the 
keyboard. Once the Portfolio Keyboard BIOS Getkey ready Service (Int 16H Fn 0) 
has detected keyboard inactivity, it will start to decrement a timeout counter. On 
timeout, the Portfolio wii! enter its power-down sequence. Once powered-down, any 
hardware interrupt will initiate a power-up sequence. 

This timeout is dependent on whether the machine is sei to fast or slow timer ticks 
(Int 61H Fn 1FH), but is always between 128 and 256 seconds. 

It is important that all keyboard input is done via a DOS or BIOS keyboard Service 
that waits for a key press. Polling the keyboard coniinuously will quickly wear out the 
batteries. This will be obvious as the Portfolio will never power down. 

Another power wasting Operation is refreshing the LCD Controller from the Video 
RAM. If an appiication writes directly to the Video RAM, then it must be refreshed at 
appropriate intervals using Int 61H Fn 12H. It is possible to force a screen refresh 
on a keypress or on a timer-tick using Int 61H Fn 1FH. Many applications which run 
on the Portfolio, but are designed for the IBM PC require this retresh on keys as 
they assume automatic screen refreshing. Refresh on timer ticks is dependent on 
the tick speed, This can be set using Int 61 Ff Fn 1EH, 


Note: The timer tick (Int 8H and int ICH) is not the same as the IBM PC timer tick 
which occurs 18.2 times a second. It is either generated once every 128 seconds, or 
once per second. 

As a general ruie, an appiication should avoid refreshing the screen except where 
necessary. With refresh on both keys and timer ticks, and with timer ticks set to last 
(i.e. 1 tick per second), the processor spends a lot of its time refreshing the screen. 

Generating sounds using Sound generation, Melody tone generation or Tone 
diailing (Int 61H Fn 15H, 16H or 17H respectively) can draw a high current from the 
Portfolio batteries. 

The Alarm will timeout after about 15 seconds to prevent the batteries from being 
overly sti ained. 
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All peripherals will add to the power consumption, unless ihey have their own power 

source. It is recommended that an external power supply is used wherever practical 
when using peripherals. 

Düring Disk access, Tone generation, Timer tick and on each press of the return 
key, the Portfolio checks to see if its batteries are running low. If a low battery is 
detected, the Portfolio automatically powers down after displaying a low battery 

message. On power up, it will display the same message to indicate to a user the 
reason why it powered down. 

It is possible to prevent the Portfolio from powering down using Int 61H Fn 26H. This 
Service must ONLY be used if absolutely necessary, because this may force the 

Portfolio to operate outside its electrica! specification with possible damage io the 
hardware. 
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Special File Formats 


3.9.1 Diary saved file format 

The built in diary saves its data in a Standard ASCII file fornnat. To eliminate different 
date formats for different countries, the Diary Stores the information in English 
format, 

Certain information, such as repeat entries and alarm information is saved along 
with the diary entries. 

The following is an example diary file: 

6/07/89 

14:14 Technical reference 
20:00 Go home 

If an entry is a repeating entry, the time is preceded by a code letter indicating the 

repeat period. The following table lists the code letters and their associated repeat 
periods: 

d Daily 
w Weekly 

n Non Weekend, i,e. Mon-Fri 

m Monthly 
y Yearly 


If an alarm is associated with an entry, the symbol is placed on the line before 
the time. 

If an entry has an alarm and it is a repeating entry, the repeat symbol preceeds the 
alarm symbol. 

For example: 

6/07/89 

@ 20:00 Go home 

7/07/89 

d 14:48 Hello there! 
w@ 18:10 Goto tennis 

The first entry is a non repeating entry with an alarm. The second is a daily repeat 
and the third is a weekly repeat whichf will sound the Portfolio’s alarm. 

The diary sorts the entries chronologically when it loads any given file. 
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3.9.2 System File Formats 

There are three flies used by the System which obey a Standard file format. These 


Clipboard (C:\SYSTEM\CLIPBORD.DAT) 
Undelete (C:\SYSTEM\UNDELETE.DAT) 
Permanent data (C:\SYSTEM\PERMDATA DAT) 


All three flies are loaded into RAM when the applications are invoked Operations 
affecting any of the Information stored in these files only change the RAM copy All 

<Fqr l fr! 6 , Wnt ! en ° Ut When the USer quits al1 the aPP'ications, i.e. presses 
<ESC> at the top level menu. 


3.9.2.1 CLIPBORD.DAT 


Inrilnn ^h 6 Wh '°K wn PP l ICat '° nS use as the clipboard. It is a single block of data 

ö S Vth ^ 6 °° h ' Carnage retums are s1ored as ODh without the trailing 

in^, hL fh n r " axlmum sl « Of the clipboard is 8K characters. This must 
include the 0 terminator. 


dfabTarri d ^mii=°rl,T« n ,h in n °° h terminati ° n W». then the file is not loaded into the 
ckpboard. Simila ly. if the file is greater than the maximum number of allowed 

characters, it isn t loaded. In both cases when the file is not loaded, it wili be 
overwritten with a fresh file upon exit from the application. 


If the clipboard has the normal text format of ODh.OAh the 
into the Editor and the Diary. 


file will only load correctly 


3.9.2.2 UNDELETE.DAT 

the e annMn!fii e file .' s used to store al1 the characters or blocks of data deleted from all 
applications. It is made up of a number of "blocks" of data. Each block 

isTsToTows 3 Sr ° UP ^ CharaCt6rS de[eted with one com mand. The format of a block 
<DATA> <00h> <DIR> 

HpI^1h ATA | > ' S the character or characters which are deleted. If a block of data is 
deleted containmg carriage returns, these are stored as <0Dh>, not <0Dh><0Ah>. 

The 00h byte is used to determine the length of the deleted block. 



he < D! R> is a one byie code indicaiing in which direction the deletion was made [f 

he , da ' ta ^ de ‘ et 1 f d t0 the ieft - I e - using the BACKSPACE key, then this byte will 

h° m mls° 0h> ' thS data WaS delGted from the right, i.e. using <DEL>, this byte will 
□ G * U ] n * , 


The max'mum number o( characters which the undeletion fiie can contain is 2000 if 
the file contains more than this number of bytes, then it will be ignored and replaced 
with a new fiie upon exiting from the application 


If the UNDELETE.DAT fiie doesn’t have the correct format, the effects 
unpredictable. It is iikely the data in the fiie will be inaccessable. 


are 


39.2.3 PERMDATA.DAT 


The format of the System data fiie is as follows: 


Byte(s> Function 

in Hex 


0 

1 

2 

3 

4.,6 


7 

8.. 56 
57 

58.. 5b 
5c 

5d 

5e,.60 


61 

62.. bO 
b1..b4 


b5 

b6..104 

105.. 106 

107.. 108 

109.. 10a 
10b 

10c 

b0d..10e 


Non zero: undelete buffer enabled. 

Non zero: undelete buf is saved on exit 
Non zero: clipboard is enabled. 

Non zero: clipboard is saved on exit 
Reserved, 

Worksheet: 

Non zero: frame on upon eniry. 
Drive/Path/Name ol last used fiie, 

0: Autofoad last spreadsheet, Offh don’l 
3 character 0 terminated currency string. 
Initial decimai point, '.’(2eh) or ’,’(2dh) 
Printer default paper width, 

Reserved, 

Diary: 

Non zero: frame on upon entry. 
Drive/Path/Name of last used fiie, 
Reserved. 

Editor: 

Non zero: frame on upon entry. 
Drive/Palh/Name of last used fiie. 

Top line on screen 0 is first fine in fiie 
Current Cursor fine no, 0 is first iine. 
Cursor: number of bytes into current fine. 
Right margin. 

Non zero: Word wrap on. 

Reserved. 
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lOf 

110.. 15e 

15f.. 168 

169.. 16f 


Address book: 

Non zero: (ranne on upon enlry. 
Drive/PattVName of last used file, 
Diaf prefix in ASCil, zero terminaled. 
Reserved. 


Calculator: 


170 

Non zero: frame on upon entry. 

171..IbJ 

Reserved. 

IcO 

Ml sign: Bit 7 sei (or negative number. 

1c1..1c2 

Ml exp: signed word, 0:1.000<=mant<2,000 

1c3..1ca 

Ml mantissa. 

1cb..1d5 

Memory 2. 

1d6..1e0 

Memory 3. 

lei..leb 

Memory 4. 

1 ec.. 1(6 

Memory 5. 

1f7 

Format: O-Generat, 1-Frxed, 2-Sci„ 3-Eng. 

1(8 

Number of decima! piaces 

1(9 

Separators: 0 - none, non-zero-separators 

1 fa 

Decimal point: 0 - non-zero 

Setup: 

Ifb 

Reserved, 

1(c..24a 

Drive/Path/Name of printer file destination 

24b..24e 

Reserved, 

24f 

Printerdest, 0:Parallel, 1:Seria1, 2:(ile. 

250 

Lines per printer page. 

251 

Printer selup code length. 

252..2dl 

Setup Codes, ASCII chars, i.e. ESC=1Bh. 

2d2 

End of fine code 0 <CR> 

1 <CR><LF> 

2 <CR><LF><LF> 

2d3 

Number of top paper margin lines. 

2d4 

Bottom paper margin lines! 

2d5 

Left paper margin character indent. 

2d6 

Baudrate 0 110 

1 150 

2 300 

3 600 

4 1200 

5 2400 

6 4800 

7 9600 

2d7 

Parity 0 None 

1 Odd 

3 Even 

2d8 

Data bits 2 7 bits. 

■ 3 8 bits. 

2d9 

Slop bits 0 1 stop bil. 

1 2 stop bits. 


The PERMDATA.DAT file currently contains 730 bytes 


3.10 IBM PC Development System 


The Portfolio contains a few System specific extended BIOS functions whlch are 
accessed using interrupt 61H. If you want to emulate these functions when 
developing programs on a Standard IBM PC then this is possible by running the 
program 161.EXE on a PC, This program will remain Terminate and Stay Resident 
(TSR) and hence enable you easily develop custom programs. To ensure upward 
compatibility of your programs. if you plan to use any 161 functions then make sure 
that you use 161 Fn OH first. (See section 3.3,1.) 

Int 61H Services supported by IBM hosted Version: 


Fn No 

Function description 

Supported 

OH 

Service Initialization 

7 

7H 

Format Credit Card Memory 

X 

8H 

Get size of Internat disk 

7 

9H 

Format Internat disk 

X 

BH 

Determine if CCM present 

X 

DH 

Get/Set Screen size 

7 

EH 

Get/Set Screen mode 

7 

FH 

Get/Set Cursor mode 

7 

10H 

Get/Set virtual screen Position 

7 

11H 

Move virtual screen Position 

X 

12H 

Screen refresh 

X 

15H 

Sound generation 

7 

16H 

Melody tone 

7 

17H 

Dial number 

7 

18H 

Mute States 

7 

13H 

Get Serial port Parameters 

7 

IAH 

Get Periphera! ID byte 

X 

1BH 

Set Peripheral ID byte 

X 

ICH 

Presel Peripheral iO data 

X 

1EH 

Get/Set Clock tick speed 

7 

1FH 

Get-key/Tick Screen refresh 

Xt 

20H 

Disable revectoring of Int 9H 

Vi 

24H 

Get/Set ROM space state 

X 

26H 

Get/Set Power State 

X 

28H 

Get/Set Language 

7 

2CH 

Get BIOS Version number 

7 

2DH 

Turn System off 

X 

2EH 

Enable/Disable Status line 

7 

30H 

File transfer via smart cable 

7 

Key: 

7 Service supported 



x Service not supported 


■1^ 

Service parily supported 
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4 PERIPHERALS 


4.1 Portfolio Serial Communications 

4.1.1 Hardware Specification 


Standard: 

Line Voltages; 
Current Loop: 
Connector: 


EIA RS232C compatible 
+/- 9V 

Not Supported 

9 Pin D-Shell Plug (AT compatible) 


Connector Pin ouf: 


Interface IC: 

Base Address of 82c50: 
Interrupt Support: 
Divisor Clock: 


Pin 

Name 


1 

CD 

Carrier Detect 

2 

RD 

Receive Data 

3 

TD 

Transmit Data 

4 

DTR 

Data Terminal Ready 

5 

GND 

Signal Ground 

6 

DSR 

Data Set Ready 

7 

RTS 

Request To Send 

8 

CTS 

Clear To Send 

9 

RI 

Ring Indicator 


82C5QA 

Stored at Memory Location 400h 
Yes (see below) 

1.8432 MHz 


4.1.2 IO Registers 

Since the same Computer interface (with the exception of interrupt handling) is used 
on the Portfolto as on the IBM PC/AT, the IO registers have the same function. The 

th aS Di^ reSS *° r seria ' port may be f° und by reading memory location 400h in 
he BIOS data area. If the value at this address is XXXXh, then the IO registers are 


IO Address Register of 82c50A 


XXXX+0 

R 

RBR 


W 

THR 

XXXX+1 

R/W 

IER 

XXXX+2 

R/W 

IIR 

XXXX+3 

R/W 

LCR 

XXXX+4 

R/W 

MCR 

XXXX+5 

R/W 

LSR 

XXXX+6 

R/W 

MSR 

XXXX+7 

R/W 

SCR 


Receiver Buffer Register 
Transmitter Buffer Register 
Interrupt Enable Register 
Interrupt Identification 
Line Contro! Register 
Modem Control Register 
Line Status Register 
Modem Status Register 
Scratch Register 
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4.1.3 Interrupt Support 


r^'ii 6 Po ; lfoli ° does n °< conta ' n an 8259 compatible Peripheral Interrupt 
on roHer, Interrupts are handled in a different way than on an IBM PC/AT. 

IlnhfhiTn 1 P °h h3S re u 9iS ' er Ca " ed ' he Serial lnterru P' Vector Register (SIVR) An 

thSt sta bau«ri wTh’f h WI ’ n ,'° lhiS reBister ' This number is the Interrupt number 

call to the Wlth ,hes f la 'Port- F°r example, writing 10 to SIVR will cause a 

call to the double word pomter heid at memory address 10*4. 

intermpts'a're ^ iS ^ ° nly ‘ " Sh ° Uld be Se ' Up be,0re 82c50A 

^h h er n in ) n err nte ! rUPt iS 9e 7 rated by the 82c50A , 1'Passed on to the CPU. If no 

Serv er S are f en U 9 ' hen ' he CPU wNI read ,he “ntents °f SIVR and 
Service that Interrupt number. 

Interrupts are acknowledged by accessing the 82c50A and reading IIR This will 
dete^ned 36 ' 3 ^ 00 reqU ' red to Service and Knowledge the Interrupt to be 


4.1.4 Other Usefui Information 

IffflnqE? Wh ( e r l ie r L 86 /' 81 P ° rt iS ins,alled ' i( is reP°mmended that use is made 
Of BIOS Interrupt 11h - Get Equipment List. 


Since the Portfolio will attempt to power down while waiting for a key stroke (INT 

kevboard“ ?•? V ' S recomme nded that terminal emulation Software polls the 
keyboard until a key is waiting in the buffer (INT 16h Service 01h). 

To set up SIVR il is recommended that INT 61h Service ich is used; 


AH = ICh 
AL = 0 
BH = 5 

BL = Byte to write 
DX = IO address 


;set up IO address 
:IO table entry 5 


Use of this function will ensure that SIVR is aiways set up correctly (unless table 
entry 5 is reused for a different address). 

° fU , tUre co ™ patibili *y '* is recommended that on exit from the 

Linu ^ K h b 6 en ry US6d above have its address sei to zero. This should be 
followed by a wnfe of 2Ah to I/O 807Fh. 


4.2 Smart Parallel Interface 
File Transfer Protocol Description 

The IBM PC and many compatibles have uni-directional Centronics parallel ports. In 
order to allow an inexpensive but useful peripheral it was decided that the Portfolio 
parallel Centronics port would allow programs to be sent to and from IBM PCs as 
well as to a printer. This is accomplished by using a synchronous serial transfer 
protocol. Status lines on the IBM PC which can be accessed through the BIOS are 
used as inputs on the IBM. The Portfolio parallel port is fufly bi-directional. 

The file transfer BIOS should be used with the following considerations (see section 
3.3.1): 

* Betöre sending or receiving the ports should be opened. 

Sending a block expects the other end to be receiving a block, and Visa versa, 

* A timeout will occur if there is no answer within 500mS. 

* Sending a block will automatically transfer the length of the block. The receiver will 
return an error if the butter is too small, 

* On any failure, wait 500mS (to allow the other end to timeout) and attempt to re- 
transmit/receive the block. 

* A error at one end will normally cause an error at the other, so block order should 
not be lost. 

* A checksum will be sent with each block to provide simple error detection. 

* At the end of the transfer the ports should be closed. 
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4.3 IBM PC Card Drive 


The IBM PC card drive consists of an expansion bus card and plastic box with a 
cable. The expansion card can be used in a IBM PC/AT or compatible. The cable is 
used Io connect the card to the plastic box. There is a slot in the front of the box that 
allows the insertion of a Credit-card memory, as used on the Portfolio. 

By running the appropriate block device driver Software, the card drive can access 
the card in the same way as a normal disk. 


The card uses a block of four I/O locations, These are located at a start address 
indicated by optional links on the board. When these are changed from the default 
setting, the device drive driver must be told of the change in the CONFIG.SYS file. 


4.4 EPROM Writer Adaptor Boards 


PROM programming adaptors are available which aliow PROM (OTP) memory 

nnnvl Hh 6 USins 8 standard PR0M programmier. The adaptors 

wpr PR ° M Cafd *° thS Same outiine as a sta ndard DIL PROM. Use mode! 
HPC 501 to program 512 KBit cards and model HPC-502 tor 1 Mbit cards. 

9 the PF L° M Card the PR0M P r °9 ramm er shoufd be set up as a 
however ’ Fujitsu settings are not available. some of the other 

specification j^ )r °^ rarnnn ^ ri ^ specifications will also work. The ideal programming 


VPP 

64 KByte 
128 KByte 


12.5V 

use 27C512 
use 27C1001 


{Ideally Fujitsu CMOS) 
(ideally NEC CMOS) 


copjTof^a RAM ca?d° M ,yPS ^ b ® en ChdSen USe ,he followin 8 Pr°cedure to make a 


i) Select a PROM card with the same capacity as the RAM 
adaptor for the card capacity 


card and use the correct 


ii) Place adaptor in PROM socket of the programmer 
correct way. 


ensure that it is inserted the 


® Ff“ R M card in ,0 ada P ,or LOAD the Contents in to the programmer 

using the relevant Option. 

iv) Place PROM card in to the adaptor and program as for a normal PROM Chip. 
WARNING: 

1) DO NOT ATTEMPT TO PROGRAM THE RAM CARD 

Smn^ e irr RO ^ P u 09 / ammerS d ° n0t like 1he P° wer being turned ON and OFF so 
remove the cards betöre Switching ON or OFF. 
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APPENDIX A: EXAMPLE .RUN PROGRAM 


Section 3.6 highlights the main design issues (o take into account when creating a 
.RUN program. 

Included on ihe Portfolio Emulator Disk are the tollowing files: 

RNRN.ASM Assembler .RUN program 
MAIN.C Example C .RUN Program 
RU_C.ASM C Header 

BUILD.BAT Creates program using Turbo C tools 

The above files illustrate two programs which use the Atari Portfolio .RUN function, 

RNRN is an assembler program which prints out the original caIIing Parameters 
and then three numbers, 

MAIN is a program which iliustrates a .RUN program written in C. RU_C.ASM is 
the C Header necessary for Borland’s Turbo C Compiler and BUILD.BAT iliustrates 
how to create the program using Turbo C tools. 

Notes on interfacing "C" files to the RUN command 

For "C" files, several more segments need to be declared to ensure "C” gets the 
data and code in the correct positions in the .RUN file. The .COM file is converted 
into a .RUN file by renaming. 

RU_C.ASM is the header which can be used to interface to a l 'C” program. If "C" 
source files are being used without any provided "C" libraries then the file RU_C 
can be used as the header directly. If library code is required the header will need 
to be enhanced to perform the necessary library initialization, 

The RUJ3.ASM header works with Turbo C and can be used as a guide to 
modifying other C headers used by different "C” Compiler libraries, 

Most "C” headers supplied with "C" Compilers can be assembled for different 
memory models. The example code in RU_C.ASM needs to be pfaced In the "C” 
startup header and assembled for the SMALL model. 


Run Files Greater than 64K 

To build a RUN file with a code size greater than 64K, it is necessary to have 
more than one code Segment. One way to achieve this is to build the program 
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usmg the MEDIUM memory model. In this way, the Code size is only limited to the 
available space on a CCM (up to 128K) 

Unlike an .EXE file, which has fixups resolved at run time, a .RUN file must have 
the fixups resolved betöre the program is committed to a ROM card. Therefore it i 
necessary to resolve the fixups based upon an absolute memory address for the 
tile, and it must be known in advance where the file will reside on the card If the 
program is the first file on the card. its Position will be cafculated as follows: 

Fixup Address (in paragraphs) = 

COOOH + (Boot sectors + FAT sectors + Root Dir sectors) * (sector size in paras) 

The number of sectors used can.be found by using a disk utility program (such as 
Nortons Utilities). 

Example: 

For a 128« card formatted with 512 bytes per sector, 1 seoior tor the Boot Record 
1 sector for the FAT, and 8 sectors for the Root Dir, the address (in paragraphs) of 
the first file on the card will be C14QH. 

This value should then be used for the fixup segment address, before the program 
is copied to the ROM card. 

Due to the mechanism used by the operating System to execute RUN fiies the file 
must have an apparent size !ess than 64K. Therefore, after the program has been 

copied to the card. the file size entry in the Root Dir must be set to a value less 
than 64K. 


r^u 06 ^ 1 ? mUSt be res ° lved at run time . it «s not possible to have more than 
b4K of data. This means Ihat the HUGE memory model cannot be used 



um: 


hnrii.asm 


caimicnt * 

(<:) Copyright DIP, 1939 

Example . RUH progiv.ni 
* 

DGROUP group _text,_data,_cdata 
STACKS1ZE equ 400 


; byte in stack. 


; Code Segment. 

_text segment public byte 'CODE' 
assume cs:_text,ds:_data 

or 9 0 | ]p is 0 on entry. 


* ****** ****** ************ 
rrtrn main 


IC Tf ** ******* * * * * * * * * ** ******** *Hf 


* * * * * * * * ** * * * * « 


. RUN command test routine. 

On entry, DS, SS and ES all point to the PSP in RAH. 

| 1S .u- ptr ’ nto tlle creciit card, so niay actually be in ROH! 

; wrien this routine is executed, the whole of RAH is allocated to the ; 


: Parameters: 
None 
Returns: 
None 




rnrn main 


proc near 


mov bx,10h 

mov ah,04ah 

int 2lh 

j c rnrnerr 

niov bx, OFFSET rnrn uend 

sub bx,OFFSET rnrn dstart 

add bx,0fh 

mov cl,4 

shr bx.cl 

add bx,STACKSIZE/16 

mov ah,48h ' 

int 21h 

je rrtrn err 


T 10h paras to keep the PSP. 

: modify mentory. 

: error reducing memory. 

alloc for initialised data, 

. uninitialised data and a 
: stack. 

:calc paras in init data area 
I add in paras in stack, 
i allocate memory. 

I allocate stack and data. 

■ no memory. 


mov 

mov 


ss,ax 


sp,OFFSET rnrn uend+STACKSIZE 


; set stack to point to RAH. 


push es 


preserve PSP pointer. 


mov cx,OFFSET rnrnjjend 

sub cx,OFFSET rnrn dstart 


bytes in initialised data. 


mov 

push 

Pop 

xor 

mov 

clcl 


si.OFFSET DGR0UP:rnrn 

cs 

ds 

di.di 
es.ax 


dstart ; copy from here. 

: source is on memory card. 
; target is allocated RAH. 


rep movsb 


copy init data from card to RAH. 


es : restore PSP ptr. 

mov si,5dh 

mov cx,ll 
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t'nrn fehl: 


mov 

dl,es:[si] 


i nc 

si 


mov 

ah, 2 


i nt 

21h 


loop 

rnrn fcbl 


mov 

si ,6dh 


mov 

ex, 11 


fcb2: 

mov 

dl,es:[si] 
si 


i nc 


mov 

ah,2 


int 

21h 

. 

loop 

rnrn_fcb2 


push 

ss 


pop 

ds 


mov 

al,_rnrn val 

5 

a 

call 

rnrn_disp 

inc 

_rnrn_val 


mov 

al,_rnrn val 

a 

call 

rnrn_disp 

?' 

r 

mov 

rnrn_unin,44 

■»; 

mov 

al,rnrn unin 

j 

call 

rnrn_disp 


xor 

al ,al 

3 

jmp 

short rnrn end 

err: 

mov 

dx,OFFSET DGROUP: 

rnrn mem 

push 

cs 


pop 

ds 

■r 

mov 

ah, 9 

int 

21h 

■ 

mov 

al ,1 


;nd: 

push 

ax 

a 


mov 

int 

pop 

mov 

int 


rnrn main 


get char trom FCß built into PSP. 
print namc of first parsed FCB. 


print name of second parsed FCB. 

; DS is ptr to data in RAH. 


get uninitialised data, 
display the value. 

: return errorlevel of 0. 


ah, 1 
21h 

ax 

ah, 4ch 
21h 

endp 


wait for a key. 


- get errorlevel code back. 
T terminate process. 


•,***************************** i , tl t*t*t**tt**t**i,***i,i, 1 l * t!l ,** i , i ,********i,*t, 

1 rnrndisp 

i 

■ Display the value in AL with a trailing space. 

: Parameters: 

AL Value to print, less than 100. 

Returns: 

None 

r'**********************************************^***,,******************'. 

I 

i convert to two nutnbers. 

: convert to ASCH digits ’0'..'9 
■ save to print 2nd char. 


print Ist digit. 


sp 

proc i 

aam 


add 

ax,3030h 

push 

ax 

mov 

dl ,ah 

mov 

ah,2 

int 

21h 
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mov 

ah ,2 


\ 

print 2nd digit. 


int 

21h 





'mov 

dl, T 

- 




mov 

ah, 2 


; 

print a space. 


int 

21h 





ret 






rnrrgdi sp 

endp 





_text ends 






; initialised 

and uninitialised 

RAM data. 



; this is para 

since 

the segment 

will Start at zero when it 

is copied 

; over into RAM. 





Jdata segment public para 'data' 



rnrn^dstart 

label 

byte 




public 

rnrn 

val 




_rnrn_va1 

db 

42 




rnrndend 

label 

byte 




rnrn_ustart 

label 

byte 

l 

uninitialised data 

Start. 

rnrn_unin 

db 

§ 




rnrnuend 

labe) 

byte 


uninitialised data 

end. 

; the stack is 

added 

on here, after initia 

lised and uninitialised data 

_data ends 






„cdata segment public byte ’data’ 



: initialised i 

data which doesn 1 t 

aet transferred to RAM. 


rnrn_meiTi 

db 

"Out of menrary$" 



_cdata ends 






end 

rnrn ■ 

ina i n 






MAIN.C 


Copyright DIP Ltd, 1989 

RUH file 'C interface main program. 


char buf[Z]; 

char *str="Hello worid"; 

unsigned int __brklvl; 

int main() 

{ 

puts(str); 

buf[01='!'; 
buf[l]-0; 

puts(&bof[0]}; 

return(O); 

} 


/* tliit. is BSS, unitialised. V 
/* this is _DATA, initialised. */ 

/* required by Turboc library. */ 

/* print initialised hello. .*/ 

/* initialise uninjtialised data. V 

/* print uninitialised data. V 


void exit() 

/* 

Duniny exit function required for the Turboc libraries. 
*/ 

{} 
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TITLE RU C.ASM 



conmient * 

Copyright DIP Ltd., J989 

'C header for creation ol .RUH files. 

Memory usagc: 

SP: Stack 

Uninitialised data 
OS/SS: Initialised data 

ES: PSP 


High memory 


Low memory 


• Segment and Group declarations 

; code and fixed data (less than 64k). 

_TEXT SEGMENT BYTE PUBLIC 'CODE' 

„TEXT ENDS 

; code ends (marker segment) 

TEXTEND SEGMENT BYTE PUBLIC 'CEND' 

TEXTEND ENDS 

; initialised data transferred into RAM, 

DATA SEGMENT PARA PUBLIC 'DATA' 

^DATA ENDS 

; uninitialised data which is allocated space in RAM. 

_B5S SEGMENT NORD PUBLIC 'BSS - 

_BSS ENDS 

; uninitialised data end (marker segment). 

JSSEND SEGMENT BYTE PUBLIC 'STACK' 

_BSSEMD ENDS 

DGROUP GROUP _DATA,_BSS,_BSSEND ; dgroup is all data segments. 

ASSUME CS: TEXT, DS:DGR0UP 


extrn jnain:near 

STACKSIZE equ 128 

; At the Start, SS, DS and ES all point 
; CS is a ptr into the memory card. 

_TEXT SEGMENT 

org 0 

Start proc near 


mov dx,ds 

add dx,10h 

mov ds,dx 

mov bx,STACKSIZE 

add bx,offset DGROUP:edata 

push bx 

shr bx,l 

shr bx,l 

shr bx,l 

shr bx,l 

add bx.llh 


; main 'C routine. 

; stack size in bytes. 
to the program segment prefix. 

■I ip is zero on entry. 

i near is irrelevant, use fn 4c to 
; terminale, 

ensure DS:0 is ptr to Ist data byte. 

■ bx has bytes of reqd RAM. 

: this will be stack ptr. 

„ 10h for PSP, 1 for rounding. 
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raov ali,4ah 

int 21h 

je abort 

pop bx 

mov ax,ds 

mov ss.ax 

mov sp,bx 

push ds 

pop es 

push cs 

pop ds 

mov si, offset TEXT:etext 

add si, Ofh 

and si, OFFFOh 

xor di,di 

mov cx, offset 0GR0UP:bdata 

inc cx 

shr cx,l 

cid 

rep movsw 

push es 

pop ds 

mov di,offset DGROUP:bdata 

mov cx,offset DGROUP:edata 

sub cx,di 

xor al.al 

rep stosb 

call „main 

mov ah,4ch 

int 21h 

abort: 

mov ax,4c01h 

int 21h 

Start endp 

TEXT ENOS 


_TEXTEND SEGHEMT BYTE PUBLIC ‘CEHD' 
etext label byte -Last 

„TEXTEND ENDS 

„DATA SEGMENT 

public errno 
_errno dw Ö 
„DATA ENDS 

8SS SEGMENT 
Edata label byte 
„BSS ENDS 

„BSSEilD SEGMENT 
edata label byte 
„BSSEND ENDS 

cnnl 


. reduce RAM to required RAM. 
: can't reduce. 

get calc'd p back.. 

- stack is in RAM, 


, target is allocated RAM after PSP. 


; source is memory card, 

. get ptr to last byte in code. 

: round up to Ist byte in data. 

■ data is para aligned on the card. 

3 ds:si is ptr to Start of init data, 
put data at 0 offs into alloc'd RAM. 
es:di is ptr to alloc'd RAM target. 
get bytes in initialised data, 
round up: ensure last byte is copied. 


i copy init data from memory card. 


. DS back to ptr to RAM. 

; ptr to where uninit data goes in RAM. 
3 ptr to end of al1 data. 

. eale bytes in BSS. 

: clear to zero. 


invoke program, 

. terminate with main’s return code. 


abort with error. 


byte of text segment 


Start 





APPENDIX B DIAGRAM OF PORTFOLIO CHARACTER SET 

(all numbers in decimal) 








































































APPENDIX C Example peripheral design 

As an Illustration of a typical Atari Portfolio peripheral we have designed a 
peripheral which flashes an LED in time with the System tick. In order that this 
peripheral operates transparently to the user we have used a ROM extension. 

Peripheral Specification 

i) have a single LED which will toggle on a timer tick. 

ii) have a PID of 64h. 

iii) have all Software on an extension ROM. 

iv) only operate with the machine powered on. 

v) be a terminating peripheral. 

vi) the peripheral wili power up with the LED off, 

Hardware Design (see schematic) 

See section 2.6 &. 2,7 for more information. 

* There is decode logic to read the PID from 8G7Fh. (Since there is no need find out 
if the LED is on or off, the latch will be decoded for a write at 807Fh, to save 
decoding logic.) 

* Each successive write to 807Fh will toggle the LED 

* If the latch is set, the LED will be ON 

* If the latch is reset, the LED will be OFF 

* The Circuit will be powered from 5VS 

* The buffering Signals ABUF/BBUF and PDET are also used 

Software Design (see tisling of fite PDEM.ASM) 

* A ROM extension will be used to hook a TSR onto INT ICh 

* Each call to INT ICh wili toggle ihe LED by writing to I/O 807Fh. 

* If the peripheral is removed, the TSR will de-insiall itself. 

* On power up, the LED is assumed to be reset, 

ROM Extensions (see Fishng of XROM.ASM) 

This example program illustrates how to design a simple ROM extension. It can 
either function as a specific BIOS, specific DOS, or Common extension, according 
to the ID code at 00000:0. Each extension moduie identifies itself, and where it was 
invoked from. It is a good demonstration of the potential power of ROM extensions. 
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Modul c: PUEM.ASM 

Copyright.: DIP Ud, 1989 

Peripheral ROM Extension 

! 



na nie 


X ROH 






assume 

cs:cseg,ds:dseg 



OOSX 


equ 

055aaH 


;Specific DOS extension 

cseg 


Segment 





org 

OH 


;Extension Vector table 

xrom 

mai n 

label 

near 


;Start label for MASH 

bi xt 

type 

dw 

DOSX 


:Identification code 

bixt 

si ze 

db 

G 


;Num 51? byte blocks in ROM 

bixt gdos 

org 

label 

jmp 

3H 

byte 

genx_vect 


;Specific DOS extension 
jSpecific extension vector 

bixt 

user 

org 

label 

db 

40H 

byte 

’Crt Plant Periph' 

TOEM user text 



;The plan is to allocate 
; of code to memory, and 
; vector to that code. 

soroe 

then 

memory, Copy a section 
point the Specified 

xroro 

proc 

proc 

FAR 




NUftß 

equ 

Ich 


;TIMER TICK 

genx 

vect 

label 

near 





push 

push 

push 

ax 

bx 

ds 


;Preserve registers 
; required to set up 
; local stack 



;A1locate User RAM. Note that 
; after OOS Initialisation. 

this can ONLY be done 



1T10V 

mov 

int 

bx,(ALOC SIZE+0fH)/10H 
ah,48H 

Zlh 

;Paras to a!locate 
;Allocate memory 



mov 

mov 

mov 

ds.ax 

stak_save,ss 

stak_save+?,sp 


;Set DS to allocated RAM 
:Preserve Caller stack 



shl 

shl 

shl 

shl 

bx,l 
bx,l 
bx, 1 
bx, 1 


;Convert size to bytes 



;Set up 

User stack. 





mov 

mov 

ss.ax 

sp,bx 


;Set up stack at top 
; of allocated memory 


push cx 
push dx 
push si 


Preserue registers 
VOU MUST ALWAVS PRESERVE 
ALL USER REGS 




;Copy the ISR to f.he allocated area 


xromproc 


PID CODE 
LEDS_P0RT 

tick Code 


push 

cts 

push 

cs 

pop 

ds 

1110 v 

si,oifset tick code 

push 

SS 

pop 

es 

mov 

di.offsot loadjiase 

mov 

cx.CODESIZE 

cid 


rep 

mov sb 

pop 

ds 

;Get 

the specified vector, i 

mov 

ax,3500H+INTR NUMB 

int 

21H 

mov 

tick_vect,bx 

mov 

tick_vect+2,es 

mov 

ax,2500H+INTR_NUHB 

mov 

dx,offset load base 

int 

21H 

mov 

ax,1501H 

int 

61H 

pop 

es 

pop 

bp 

pop 

di 

pop 

si 

pop 

dx 

pop 

cx 

mov 

ss,stak_save 

mov 

sp,stak_save+2 

pop 

ds 

pop 

bx 

pop 

ax 

ret 

endp 



;Prcservc DS 
;Set up Source 

;Set up destination 

;Bytes to copy 
rInitialise flag 
;Copy TSR to RAH 

;Restore DS 

set it to the ISR 

;Get current lnt ICH 

;Preserve vector 

;Set interrupt vector 

;Generate Confidence BEEP 
;Restore registers 

;Restore Cal ler STACK 
;Restore remaining regs 

;FAR return to caller 


; Interrupt Service Routine (ISR) 


equ 

64H 

; Peripheral PIO code 

equ 

807 f H 

;LEDs I/O address 

label 

byte 

;TSR code 

push 

ax 

;Preserve registers 

push 

dx ■ 

push 

bx 


push 

ds 


push 

es 


mov 

ah,laH 

;Get Peripheral PID 

int 

61H 

or 

al ,al 

;Peripheral installed? 

jz 

tick_none 

;No, so uninstal1 

cmp 

ah,P1D_C0DE 

jCorrect peripheral? 

jne 

ticknone 

;No, so uninstall 


;Peripheral installed, so toggle LEDs 
dx,LEDSPORT 


mov 


;Toggle LED address 



Modul c: PllJ.H. ASM 

Copyri gilt: DIP l.t.d, 1089 


Periphcral ROM Extension 


, ********** 

******** TA-* *A i- K: ür*K * ******** *■* 

***** 

************ * *■ * * * * , 

na me 

XROM 





assume 

cs:cseg,ds:dseg 



DOSX 

equ 

055aaH 


;Specific DOS extension 

cseg 

Segment 





org 

OH 


jExtension Uector table 

xrommain 

label 

near 


;Start label for NASH 

bixt type 

dw 

DOSX 


;Identification code 

bixt_size 

db 

0 


;Num 512 byte blocks in ROM 

bixtgdos 

org 

3H 



label 

byte 


;Specific DOS extension 


jmp 

genx vect 


;Specific extension vector 

bixt user 

org 

40H 



labe! 

byte 


;OEM user text 


db 

'Crt Plant Periph’ 


;The plan is to allocate 

some 

memory, Copy a section 


; of code to memory, and 
; vector to that code. 

then 

point tbe Specified 

xroRi proc 

proc 

FAR 



1HTRNUMB 

equ 

IcH 


;TIMER TICK 

genx__vect 

label 

near 




push 

ax 


jPreserve registers 


push 

bx 


; reguired to set up 


push 

ds 


; local stack 


;Allocate User RAM. Note 

that 

this can ONLY be done 


; after DOS Initialisation. 


mov 

bx,(ALOC SIZE+0fH)/10H 

;Paras to allocate 


mov 

ah,48H 


;Allocate memory 


i nt 

21H 



mov 

ds.ax 


; Set DS to allocated RAM 


mov 

stak save.ss 


;Preserve Cal 1er stack 


mov 

stak_save+2,sp 



shl 

shl 

bx, 1 
bx, 1 


;Convert size to bytes 


shl 

bx, 1 




shl 

bx, 1 




;Set up 

User stack. 




mov 

ss,ax 


;Set up stack at top 


mov 

sp,bx 


; of allocated memory 


push cx 
push dx 
push si 
push di 
push bp 
push es 

0-3 


;Preserve registers 
; YOU HUST AUAYS PRESERVE 
; ALL USER REGS 




;Copy the ISR to the allocated area 


xrom_proc 


PID CODE 
LE DEPORT 

tick code 


pusll 

ds 

push 

cs 

pop 

ds 

mov 

si.offset tick code 

pusll 

SS 

pop 

es 

mov 

di.offset 1oad base 

mov 

cx.CODESIZE 

cid 


rep 

movsb 

pop 

ds 

l Get 

the specified vector, ; 

mov 

ax,3500H+INTR NUMB 

int 

21H 

mov 

tick_vect,bx 

mov 

tick_vect+2,es 

mov 

ax,2500H+INTR_NUMB 

mov 

dx,offset load base 

int 

21H 

mov 

ax,15G1H 

int 

61H 

pop 

es 

pop 

bp 

pop 

di 

pop 

si 

pop 

dx 

pop 

cx 

mov 

S5iStak_save 

mov 

sp,stak_save+2 

pop 

ds 

pop 

bx 

pop 

ax 

ret 

endp 

' 


;IYeserve OS 
;Set up Source 

;Set up destiriation 

;Bytes to copy 
; Initialise flag 
;Copy TSR to RAH 

jRestore DS 

set it to the ISR 

;Get current Int ICH 

jPreserve vector 

:Set Interrupt vector 

jGenerate Confidence BEEP 
;Restore registers 

;Restore Caller STACK 
;Restore remaining regs 

;FAR return to caller 


:Interrupt Service Routine (ISR) 


equ 

64H 

;Peripheral PID code 

equ 

807fH 

;LEDs I/O address 

label 

byte 

;TSR code 

push 

ax 

;Preserve registers 

push 

dx 


push 

bx 


push 

ds 


push 

es 


mov 

ah.laH 

;Get Peripheral PID 

int 

61H 


or 

al ,al 

;Peripheral installed? 

U 

tick_none 

;No, so uninstal1 

cmp 

ah,PI0_C0DE 

;Correct peripheral? 

jne 

tick_none 

;No, so uninstall 


;Peripheral installed, so toggle LEDs 


dx,LEDS PORT 


mov 


C-4 


;Toggle LED address 


tick none: 


tick exit: 


C0DE_SIZE 

cseg 

dseg 

datajsptr 

stak_save 

tick_Vect 

load_base 

LOAD_SIZE 
ALOE S3ZE 


out 

dx.al 

. Al INI INI . ! III' 

.1 mp 

short (ick exit 

i 1 > 1 t 

assume 

cs:dseg 

;Force DSEG offset 

;Inuatid Pervpheral, so uninstal 

1 TSR 

mov : 

ax,2500H+INTRjWMB 

; Set i nterrypt \iector 

mov 

bx,offset tick vect: 

;Get öld vnctor 

mov 

ds,cs;[bx+2] 


mov 

dx : , cs:[bx] 


int 

21H 


;Uow uector reset; free allocated memory 

push 

C5 

;Segment of block 

pop 

es 


mov 

ah,49H 

;Free memory 

int 

21H 

pop 

es 

(Restore registers 

pöp 

ds 

pop 

dx 


pop 

bx 


pop 

ax 


J m P 

dword ptr cs:tick vect'" 

;Jümp to oid TSR 

equ 

S-tick_code 

;Size df TSR 

ends 



:Data segraent TEMPLATE (No initi 

segment 

alised data here!) 

label 

byte 

;Start of Data 

dw 

7 

LCaller stack stored here 

dw 

7 


dw 

? 

;Öld vector stored here 

dw 

7 

1 abel 

byte 

;Start of I SR 

equ 

(J-data sptrJ+CODE SIZE 

;Lpad module size 

equ 

ends 

LOAD SIZE+LOOH 

;Load module + Stack 

cnd 

xrom main 






: 


Modul e: XROM,ASM 

Copyright: DIP Ltd. 1D89 

ROM Extension DEMO program 


A ROM extension may he run from a Credit Card Memory 
or an Extension ROM. 

The Extension code must preserve ALL registers! 

K 

The Pre-BIOS vector MUST return by a FA.fi JMP to 
OFFFErO, as no stack is set up at this stage 

I 

* ********* ********* ***** *»#***■*■* * *** ******* *■*..*. ******** yjy, ******** 


name XROM 




assume 

cs: cseg 

LF 


equ 

OaH 

CR 


equ 

OdH 

BIOX 


equ 

Gaa55H 

DOSX 


equ 

055aaH 

8ID0 


equ 

05555H 

cseg 


Segment 




org 

OH 

xrom 

_ma i n 

label 

near 

bi xt 

type 

dw 

BIOX 

bixt 

size 

db 

0 



org 

3H 

bi xt 

„gbio 

label 

byte 

bixt 

gdos 

label 

byte 



jmp 

genx_vect 

bi xt 


org 

40H 

user 

label 

byte 



db 

'Test ROM (C) 



org ' 

50H 

bixt 

preb: 

jmp 

preb_vect 

bi xt_ 


org 

55H 

bext: 

jmp 

bext_vect 



org 

5a H 

bi xt^ 

pdos: 

jmp 

pdos_vect 



org 

5fH 

bixt_ 

dext: 

jmp 

dext_vect 



org 

64H 

bi xt 

ados: 

jmp 

adosj/ect 



org 

69H 

bixt 

pwdn: 

jmp 

pwdnvect 

bixt_ 


org 

6eH 

pwup: 

jmp 

pwup_vect 

xrom 

proc 

proc 

FAR 



;Determi 

ne extension 

genx 

vect 

label 

near 


;Line feed 
jCarriage return 

jSpecific BIOS extension 
;Specific DOS extension 
;Compiete control 

jExtension Vector table 

;Identification code 
;Num 512 byte blocks in ROM 

;Specific BIOS extension 
;Specific DOS extension 
;Specific extension vector 

;OEM user text 

DIP’ 

;Pre-bios jmp vector 
;Bios-ext jmp vector 
;Pre-dos jmp vector 
;Dos-ext jmp vector 
;Post-dos jmp vector 
;Power down jmp vector 
;Power up jmp vector 




push 

bp 

;Preserve Bi’ 


cmp 

cs:|0].HIOX 

:Specific BIOS extcnsion 


jne 

not genb 

; No 


mov 

bp.ol fset gbio text 

;Specific BIOS ex!n 1ext 


jmp 

short, xrom disp 


not_genb: 





cmp 

cs: [0] ,l)OSX 

;Specific OOS extension ? 


jne 

not_gund 

;No 


1110 V 

bp,offset gdos_text 

:Specific DOS extn text 


jmp 

short xrom disp 


notgend: 





nio v 

bp,offset invl text. 

;Inval id text 


jmp 

short xrom disp 


preb_vect 

1 abel 

near 



jmp 

dword ptr cs:preb_retn 

;Pre-BIOS extension 

prebretn 

dw 

0 



dw 

Offfell 


bext_vect 

label 

near 

;Post-BIOS extension 


push 

bp 



mov 

bp,offset bext text 



jmp 

short xrom disp 


pdos vect 

labe) 

near 

;Pre-DOS extension 


push 

. bp 



mov 

bp,offset pdos text 



jmp 

short xrom disp 


dext_vect 

label 

near 

;DOS extension 


push 

bp 



mov 

bp,offset dext_text 



jmp 

short xrom disp 


ados_vect 

label 

near 

;Post-DOS extension 


push 

bp 



mov 

bp,offset ados_text 



jmp 

short xrom disp 


pwdn_vect 

label 

- near 

;Power-Down extension 


push 

bp 



mov 

bp,offset pwdn text 



jmp 

short xrom_disp 


pwup_vect 

label 

near 

pPower-Up extension 


push 

bp 



mov 

bp,offset pwup_text 



jmp 

short xrom_disp 


xrom disp 

label 

near 

;Hain display routine 


push 

ax 

;Preserve registers 


push 

bx 



push 

cx 



push 

dx 



push 

es 



cal 1 

disptext 

;Display text in IIP 


mov 

ax,2400H 

;Get ROH state 


int 

61H 



or 

dl .di 

;Normal ROH ? 


07 



jnz 

noLnorm 

;Ho. so skip 


mov 

bp,□(fsi't norm text 

;Get normal ROM text 

nat_norm; 

jmp 

short, stnl disp 


dec 

dl 

;Drive A ? 


jnz 

nat_drva 

;No, so skip 


mov 

bp.Offset drva text 

;Get Drive A text 

notdrva; 

jntp 

short stat disp 


dec 

dl 

;Drive B ? 


jnz 

not^drvb 

;Ro, so skip 

not^drvb: 

mov 

jmp 

bp,offset drvb text 
short stat disp 

;Get Drive B text 


dec 

dl 

;Drive 8 ? 


jnz 

not^xrom 

;No, so skip 


mov 

bp,offset xrom text 

;Get Drive B text 

not xrom: 

jmp 

short stat disp 

statjdisp: 

mov 

bp,offset invl text 



cal 1 

di sptext 

;Display text in BP 


mov 

cal 1 

bp,offset crtf text 
disptext 

; Final ly CR, LF 


pop 

pop 

es 
dx' 

;Restore registers 


pop 

cx 



pop 

bx 



pop 

ax 



pop 

bp 



ret 


;FAR return 

xrom proc 

endp 



.*********** 

********** 


WK******** ******* *. 

t 

: Main 

Display routine 

* 


„»****************, 

disptext 

proc 

near 



xor 

mov 

int 

' bh,bh 
ah, 3 

10H 

;Page 0 

;Get Cursor Position in DX 


push 

cs 

;Access text 


pop 

es 


xor 

ch,ch 

; Initialise 


mov 

cl,es:[bp] 

bp 

;Get length 


i nc 

;Advance to text 


mov 

int 

ax,1301H 

10H 

;Write string 


net 



disp_text 

endp 



gbiojext 

db 

gdos_text-$-i 
’Spec BIOS Extension - 



db 

- 

gdos_text 

db 

bext_text-$-l 



db 

’Spec DOS Extension - 


bexttext 

db 

pdos_text-l-l 



db 

'Com BIOS Extension - * 



08 





pdos text 

tili 

dext i <;xt -S -1 


db 

’ Pro-DOS i'xU'nsio:' ■■ 

dext_ text 

db 

ados U‘xt-$-i 


db 

'Com DOS [.xlensioii - 

adostext 

db 

pwdn_tcxt-$-1 


db 

'Post-DOS Extensioi'i - 

pwdn_text 

db 

pwup_text-$-l 


db 

'Power Down Extension 

pwup^text 

db 

norni_text-$-l 


db 

'Power Up Extension - 

nom^text 

db 

drva text-$-l 


db 

' Morina 1 ROM 1 

drva__text 

db 

drvb text-$-l 


db 

'CCM Drive A' 

drvb_text 

db 

xrom text-$-l 


db 

’CChf Drive B’ 

xromtext 

db 

invl text-S-l 


db 

’Extn ROM’ 

invltext 

db 

crlf_text-$-l 


db 

'Invalid' 

crlftext 

db 

£,CR,LF 

cseg 

ends 



end 

xrom main 
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APPENDIX D Memory size and assignment 


REDUCING STACK OR MEMORY SIZE 


Some compiled (.EXE) programs require reduced stack or memory size 
requirements when designed for the Portfolio. Reduced stack or memory size 
requirements are also needed when executing some buiit in appiications. 


Microsofts Assembler includes a utility (EXEMOD) which allows modification of 
maximum required memory Word in the .EXE header. Modifying the header allows 
the appiications room in which to execute. 


MEMORY ASSIGNMENT 

Portfolio Software developers should include the following interrupt Information in a 
header: 

INT 21 fn 4ah 

This DOS function reduces memory used to the amount required by the oroaram 
rather than defaulting to all memory. 


D-1 


